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WHY BLACK BOOK ? 


The initial idea, for a manual of this type began in 
the period of the Vic-20. I had accumulated my notes 
and tid-bits of information, between the covers of a 
small black note-book. Soon it bulged with homespun 
charts and long lists of facts. By the time the 1541 
disk drive, and C-64 arrived on the scene, the black 
note-book had become entirely out of hand. Odd notes 
were written on scraps of paper with no order what- 
so-ever. My son became curious, and read what I had. 
I was soon informed, that the information I had been 
Saving would be of use to him also, PLEASE SHARE. 


The note-book continued to grow, but with a new sym- 
bolism of order. The memory of the C-64 and the 1541 
became of special interest. I dumped everything to a 
printer and triggered the laborious investigation of 
what was happening. This went on for months. Just as 
I was about to finish along came the C-128. 


The idea of three computers in one case was a chall- 
enge beyond my dreams. I purchased the first C-128 I 
could find. The box sat un-opened, for better than a 
week. Finally my youngest son ask the question, 'mom 
why did you buy that thing if you are going to leave 
it in the box?'. When I told him I had what I wanted 
, the owner's manual, I received very strange looks. 
As it turned out, he got the computer, and I got the 
book. The questions in my mind, soon rose beyond the 
book, I needed the computer too. My son was so deep- 
ly involved with the C-128, that I couldn't get near 
it. Can you believe, I was forced to buy another en- 
tire computer system. 


The original black note-book was ragged from use. It 
had become the most read book in the house. At times 
we almost fought over that poor tattered thing. Then 
came the final word, both my sons wanted it up-dated 
for the C-128 as well as the 1571. Well, if I was to 
devote that much time to the additions, why not have 
it printed and share the end result with everyone. 
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It was a blessing that my youngest son became inter- 
ested in the project, without his help Black Book of 
C-128 would not be in print. In the months that fol- 
lowed, he continually reminded me of an old computer 
terminology, 'KISS' ( Keep It Simple Stupid ). Kiss 
became a household word. Every time I sat down to my 
desk to write, a member of the family, would remind 
me to KISS. - A hug goes to Robert, without his help, 
I could never have finished. 


This is a book about a computer. I felt it would be 
appropriate, that the text be printed, directly from 
my print-outs, and not type-set by a print shop. 

The following equipment/software was used: 


Commodore 128 

Commodore 1571 Disk Drive 
Commodore 1541 Disk Drive 
Commodore 1701 Video Monitor 
Panasonic Printer K-X 1092 
Easyscript (word processor ) 


Welcome to the pages of my little black note-book. I 
sincerely hope you find it as useful, as the members 
of my family do. If you have suggestions or subjects 
you would like to see added to a future update, ple- 
ase drop me a note via the publisher. 


Dell Taylor 


'granny' 
Feb. 1986 
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INTRODUCTION 


The Black Book of C-128 has been developed as a vast 
reference source to assist programmers of all levels 
from the beginning BASIC student, to the experienced 
machine language writer. Think of it as a dictionary 
or extensive reference source. The aim of this book, 
is to support the user, not teach BASIC programming. 


The Commodore 128 is one of a long line of computers 
from Commodore Electronics Ltd. Originally the comp- 
any repaired typewriters. The first computer design- 
ed by Commodore, was for Radio Shack Inc.. After re- 
view of the new machine, they decided to design and 
manufacture the TRS-80 in it's place. Commodore went 
on to market the successful Pet (Personal Electronic 
Transactor). Many claim the Pet was really named for 
the then popular 'Pet Rock'. The series was a leader 
in the industry and many are still in use today. 


Commodore had the foresight to see the coming market 
for personal computers. The vision of a computer in 
every home was the dream of all computer developers. 
There were three questions yet to be answered, why, 
how, and is the public really ready for the move. 


The next computer designed by Commodore, was the TOI 
(The Other Intellect) or as some people joked, Tools 
Of Idiots. The TOI was put aside to develop an inex- 
pensive color computer, the Vic-20. The TOI was not 
to be, but many of it's exceptional features found a 
Place in the future C-64. 


The Vic-20 was the breakthrough, to the home market, 
for Commodore. With sound, color, and low price tag, 
the stage was set for the entire industry. Other new 
computers appeared, and dis-appeared, most could not 
or would not compete with the volume marketing tech- 
nics of Commodore. 


The arrival of the Commodore 64, set industry stand- 
ards for the home computer. A personal computer must 
have color, sound, graphics, and most of all be easy 
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to use. The new version of the 6502 chip, opened new 
worlds for the purchaser. The flexibility of RAM and 
ROM, allowed use of languages other than BASIC, plus 
better control for the user. 


Today the Commodore 128 is taking the personal comp- 
uter market by storm. Three computers, in one case, 
that is a bargain. 


* C-64 MODE..All the features of the reliable C-64, 
compatibility with hundreds of the existing software 
packages and the C-64 peripherals. The color, graph- 
ics, and sound abilities, are identical to the orig- 
inal. BASIC 2.0, 40 column output and access to 64K 
RAM (Random Access Memory) have been retained. 


* C-128 MODE...128K of available RAM (Random Access 
Memory), expandable to 512K. BASIC 7.0 has over 150 
easy to use commands. The 128 mode, offers 40 or 80 
column output, plus a 92 key keyboard including nun- 
eric keypad. A machine language monitor is available 
via pre-programmed function keys. 


*CP/M MODE.....CP/M is the abbreviation for Control 
Program for Microprocessors. This mode enables a 280 
microprocessor chip, 59K of RAM (Random Access Mem- 
ory), 40 or 80 column video output, full 92 key key- 
board, and access to the new fast serial disk drive. 


As you proceed from one mode to another, the config- 
uration of components within C-128 change. The next 
three pages, are diagrams of which components are in 
use for each of the three modes. The shaded areas of 
the drawings are in use, the blank ones are not. 
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HOW TO USE 
THE BLACK BOOK of C-—128 


This book was written in a manner, to quickly answer 
questions on a given subject. The standard format of 
text often becomes to lengthy, for the quick identi- 
fication of material. Information has been converted 
to chart or table form when ever possible. Text has 
purposely been kept to a minimun. 


Each of the following subjects, are identified by a 
different color. 


C-64 MODE RED 


C-128 MODE BLUE 

CP/M MODE DARK GREEN 
1541 DISK DRIVE LIGHT GREEN 
1571 DISK DRIVE YELLOW 
GENERAL INFORMATION ORANGE 
PERSONAL GOLD 


A color divider, has been placed at the beginning of 
each of the above subjects. The color is also at the 
top of each page in the given section. 


The page following each colored divider, contains a 
detailed table of contents for the chapter. 


When ever possible, an example of use, or the proper 
syntax (command sentence structure) is included. The 
following format has been used for all syntax of 
BASIC 2.0 and 7.0: 


1. BASIC keywords are shown in capital letters. 


2. Items shown within quote marks (" ")are user 
definable. 


3. Items shown within square brackets ([{ ]) are an 
optional range. 
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BASIC 2.0 DICTIONARY 


The computer language most commonly used by Commodore 
computers, is referred to as BASIC, ( Beginner's All 
Purpose Symbolic Instruction Code ). It was developed 
by John Kemeny and Thomas Kurtz in the mid 60's as an 
alternate to machine language. People could relate to 
common words much easier than a lot of numbers. As in 
any language, BASIC has it's own vocabulary. The for- 
mat, in which BASIC code must be entered, is referred 
to as syntax. Computers are very fussy about how you 
talk to them, infact at times, down right un-friendly 
if code is not written just the way it likes. When an 
error has transpired, the message 'SYNTAX ERROR' will 
appear on your monitor. This is telling you to check 
spelling, punctuation, etc. 


The BASIC 2.0 reserved words, are the language of the 
C-64. These words are also included, in BASIC 7.0 of 
the C-128. You may use both 2.0 and 7.0 in the C-128 
mode. 


The following pages are a mini-dictionary of 7.0 key- 
words. On the first line of each entry is the keyword 
and an example of the proper syntax. The second line 
contains a brief definition, of the function the word 
performs. 





ABS 20 x=ABS(8. 25) 
Returns the absolute value of a number. 


AND if k=3 AND y=0 then500 
Checks the truth of multipule operands. 


ASC 100 print ASC(a$) 
Returns the ASCII value of a character. 


ATN 230 print ATN(0) 
Returns the artangent of a number. 
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a SA I ET I 


CHRS 200 print CHRS$(48) 
Converts Commodore ASCII to it's char. equivalent. 


CLOSE 100 CLOSE15 
To CLOSE an open logical file or device. 


CLR 10 CLR 
Clears a program file of all variables. 


CMD 200 CMD1 
To send a file to the desired channel. 


CONT CONT 
Restarts a program after a STOP or END command 


cos 200 COS(0) 
Calculates the cosine of a number. 


DATA 40 DATA 48,0,255 
Used to store information within a program. 


DEF FN 20 DEF FN z(3)=x + y 
A user defined function for later use in a program. 


DIM -10 DIM a$(100) 
Defines an array or matrix of variables. 


END 900 END 
Ends a program run and displays the READY message. 


EXP 100 print EXP(3) 
Returns the value 2.71 raised to the x power. 


FN 100 print FN b(x) 
The value of a function created by DEF FN statement. 


FOR 100 FOR x=1 to 200 
Used with NEXT to repeat a section of code for a set 
number of times. 
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FRE 100 print FRE(0) 
Returns the number of unused bytes. The value will 
be negative if over 32K. 


GET 100 GET a$:if a$="" thenl00 
To GET one character from the keyboard. 


GET# 100 GET#5,a$ 
Get one byte from an external device. 


GOSUB 100 GOSUB500 
Tells the computer to branch to a subroutine. 


GOTO 100 GOTO450 
Tells the computer to GOTO a specified line number. 


IF THEN 100 IF a<>0 THEN600 
A statement to evaluate and command to do. 


INPUT 100 INPUT n$ 
Prints question mark and waits for user input. 


INPUTH# 100 INPUT#5,a$ 
To retrieve data stored ina file. 


INT 200 print INT(a) 
Returns the integer value of a number. 


LEFTS 200 a$=LEFT$(x$,1,3) 
The left most character of a string. 


LEN 140 if LEN(a$)=4 then450 
Returns number of characters in string expression. 


LET 100 LET a=20 
To assign a value to an array. 


LIstT LIST 
To look at a program in memory, screen or print same 
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LOAD LOAD "menu",8 
Reads contents of file from disk or tape into memory 
memory 

LOG 100 x=LOG( 45/7) 


Returns the natural logarithm of argument 


MIDs 100 a$=MID$(x$,1,5) 
A sub-string of a larger string. 


NEW NEW 
Clears BASIC memory and all variables. 


NEXT 300 NEXT X1 
Used with FOR to create an end of a FOR NEXT loop. 


NOT 500 if NOT dd = xx then 850 
Reverses the meaning of a statement. 


ON GOTO 600 ON a GOT500,600,700 
GOTO the line number shown after the GOTO command. 


ON GOSUB 600 ON a GOSUB500,600,700 
Goto the line number shown after the GOSUB command. 


OPEN 700 OPEN15,8,15 
OPENs channel for input/output to peripheral device. 


OR 700 if a=3 OR z=1 then 450 
Links two expressions into a single compound. 


PEEK 300 if PEEK(49152)=162 then 800 
Returns the value of a memory location. 


POKE 100 POKE53280,1 
To change the contents of a memory location. 


POS 200 if POS(0)>40 then print chr$(13) 
Identifies the current cursor position. 
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PRINT 100 PRINT "hello" 
To output data to the screen. 


PRINT# 150 PRINT#4, "hello" 
To output data to a file or device. 


READ 160 READ d$ 
fo fill variables from a DATA statement. 


REM 10 REM program name: mail 
To be used for user REMarks or re-minders. 


RESTORE 20 RESTORE 
Resets pointer to the first statement. 


RETURN 100 RETURN 
To exit a sub-routine called by a GOSUB. 


RIGHTS 120 if RIGHTS$(xz$,1)="y" then 450 
The right most character of a string. 


RND 100 a=(RND(0)*100) 
Generates a random number sequence. 


RUN RUN 
To start a program currently in memory. 


SAVE SAVE "menu", 8 
To store a file to disk or tape. 


SGN 400 if SGN(d)<O then print "error":end 
Returns the sign (pos., neg., or zero) of X. 


SIN 300 x=SIN(a) 
Gives the sine of the <numeric) argument, in radians 


SPCC 400 print SPC(20) "hello" 
Skip X spaces forward on the same line. 





- 14 - 


ee 














<«-- C-64 MODE RED --> 





SOR 350 a=SQR(d) 
Returns the square root value of a positive number. 


STATUS 400 if ST<>0 then print "error" 
Shows STATUS of last input or output performed on an 
open file. 


STEP 450 for x=1 to 250 STEP 2 
Defines the value of increment for a loop 


STOP 900 STOP 
To stop the execution of a program. 


STRS a$=STR$(a) 
Converts a number to a string. 


sys 800 if st<0 then SYS64738 
Execute a machine language program at xxxxx memory 
location. 


TAB 100 print TAB(15) "welcome" 
Move X spaces forward on the same line. 


TAN 355 x=TAN(a) 
Returns the tangent value of expression in radians. 


TIL 675 print TI 
Reads the interval timer (jiffy clock). 


Tis 850 TI$=x$ 
Used to set time in the internal timer. 


TO 555 for x=1 TO 500:next x 
Used as part of the FOR statement. 


USR 855 d=USR(a) 
Transfer to a machine language program. 
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VAL 655 v=VAL(x$) 
To convert a string to a number. 


VERIFY VERIFY “menu",8 
Compares a saved file against one in memory. 


WALT 335 WAITI, 32,32 
To pause until data matches. 


AARP ISP A ET TE 


BASIC 2.0 ABBREVIATIONS 


Most BASIC commands, statements, and functions can be 
abbreviated to a shorter form. Listed in column one, 
are the keywords. Columns two and three are the equi- 
valent in hexadecimal and decimal. Column four is the 
abbreviated version. 


To enter an abbreviation: type the letter or letters 
shown before the word shift. Next hold down the shift 
key and type the remaining letters. 


KEYWORD HEX DECIMAL SHORT-HAND 


00182 
00175 
00198 
00193 
00199 
00160 
00156 
00157 
00154 
00190 
00131 
00150 
00134 
00128 
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HEX 


DECIMAL 


00189 
00165 
00129 
00184 
00161 
00161 
00141 
00137 
00139 
00133 
00132 
00181 
00200 
00195 
00136 
00155 
00147 
00188 
00202 
00162 
00130 
00145 
00159 
00176 
00194 
00151 
00185 
00153 
00152 
00135 
00143 
00140 
00142 
00201 
00187 
00138 
00148 
00180 
00191 


SHORT-HAND 
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KEYWORD HEX DECIMAL SHORT-HAND 


SPC( 

SOR 

STATUS 

STEP 

STOP 

STR§ 

sYs 

TAB( 

TAN 

TIME 00073 
TIMES $54 $49 00073 00036 
TO $A4 

USR $B7 

VAL $C5 

VERIFY $95 

WAIT $92 





BASIC 2.0 ERROR MESSAGES 


An error message is the computer's way of telling you 
something is wrong. When exploring for the cause, you 
must remember that a computer is very exacting in its 
demands. One forgotten comma, will generate a syntax 
error. I recently talked to a gentleman, that went so 
far as to name his computer shop 'Syntax Error'. The 
idea came from using his computer. Programmers have 
seen the message so often, that they never forget it, 
talk about free advertising. 


The clues to an error, are often subtle. Stop, think, 
take time to review the problem completely. The ans- 
wer is usually in plain sight. The computer can only 
follow your instructions. 

TS RTL MY SE A RANA DE IE SHEA ATO DOE ENE DAE ECO IRE EAE EL, SOE IED RLS EE TIER EEE LD LG EAA IAA SPER EDIE 


BAD DATA String data received from open 
file, numeric data expected 
BAD SUBSCRIPT Array number outside range in 


Dim statement 


«48 = 
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EPR SP TS LI 


BREAK IN XX STOP pressed during execution 
CAN'T CONTINUE CONT not possible at this time 
DEVICE NOT PRESENT Required I/O device not on line 
DIVISION BY ZERO By zero not allowed 


EXTRA IGNORED Extra input data ignored 
FILE NOT FOUND File not found on device 

FILE NOT OPEN Tried to access a closed file 
FILE OPEN Tried to open an open file 


FORMULA TOO COMPLEX String operation too complex 
for the computer 

ILLEGAL DIRECT INPUT may be used in program 
only, not in direct mode 

ILLEGAL QUANTITY Argument out of allowable range 


LOAD ERROR Tape PRG has loading error 

NEXT WITHOUT FOR Executed NEXT before FOR found 

NOT INPUT FILE Tried to read a file opened 
for write only 

NOT OUTPUT FILE Tried to write file opened for 
read only 

OUT OF DATA No data left to read 

OUT OF MEMORY All available memory in use 

OVERFLOW Numerical result greater than 
maximum 

REDIM'D ARRAY Tried to DIM an array more than 
once, this is not allowed 

REDO FROM START Wrong data type entered 

RETURN WITHOUT GOSUB RETURN found before a GOSUB 

STRING TOO LONG Limit is 255 characters 

SYNTAX Error in punctuation, 
spelling, etc. 

TYPE MISMATCH Wrong data type 


UNDEF'D FUNCTION Function un-defined by DEF FN 
UNDEF 'D STATEMENT Line number does not exist 
VERIFY ERROR Program in memory does not 


match one in device 
a nemememeeel 
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C-—64 CONTROL CODES © 


The CONTROL may be found at the middle left-hand side 
of the keyboard. The key generates control functions. 
These are often special tasks, or short cuts, to much 
larger jobs. To perform a control function, hold down 
the CTRL key, and press the other key that is called, 
for at the same time. The CHR$ functions are an ano- 
ther way of doing these same tasks within BASIC code. 
The CHR$ refers to a table, of character string codes 
in the computers memory. The CHR$ function converts a 
Commodore ASCII code to its character equivalent. 


c= Commodore logo key, location, lower left corner 
of the keyboard. 


char. = character 


a aa aa 


CHR$ CTRL KEY FUNCTION 

CHR$(5) CTRL2/E Set char./color to white 
CHRS$(8) CTRL H Disable char. set change 
CHR$(9) CTRL I Enable char. set change 
CHR$(10) CTRL J Carriage RETURN/line feed 
CHR$(13) CTRL M Send carriage RETURN 
CHR$(14) CTRL N Char. set to up/low/case 
CHR$(17) CRSR DN/CTRL Q Cursor down one row 
CHR$(18) CTRL 9 Reverse field characters 


CHR$(19) HOME/CTRL S Cursor to home position 
CHR$(20) DEL/CTRL T Delete char./fill hole 
CHR$(24) CTRL X Tab set/clear 

CHR$(28) CTRL3/CTRL/ Character color to red 
CHR$(29) CRSR/CTRL) Cursor one column right 
CHR$(30) CTRL6/CTRL Character color to green 


CHR$(31) CTRL7 Character color to blue 
CHR$(34) . Prints a quote mark 
CHR$(129) C=l Character color to orange 
CHR$(131) Run PRG, keyboard only 
CHR$(133) F1 Reserved CHR$ for Fl key 
CHR$(134) F3 Reserved CHR$ for F3 key 
CHR$(135) F5 Reserved CHR$ for F5 key 
CHR$(136) F7 Reserved CHR$ for F7 key 
AA EE RE RL I I TI EI PT TO STO OA IO ST SE TIE TEE 
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_CHR$ CTRL KEY FUNCTION 

CHR$(137) F2 Reserved CHR$ for F2 key 
CHR$(138) F4 Reserved CHR$ for F4 key 
CHR$(139) F6 Reserved CHR$ for Fé key 
CHR$(140) F8 Reserved CHR$ for F8 key 


CHR$(141) SHIFT/RETURN Carriage RETURN/line feed 
without BASIC code 


CHR$(142) Char. set up/case/graphic 
CHR$(144) CTRL 1 Character color to black 
CHR$(145) CRSR UP Move cursor up one row 
CHR$(146) CTRL 0 Reverse field off 
CHR$(147) HOME Cursor to home position 
CHR$(148) INST Insert command 

CHR$(149 = C=2 Character color to brown 
CHR$(150) C=3 Character color light red 
CHR$(151) C=4 Character color dk.gray 
CHR$(152) C=5 Character color med. gray 
CHR$(153) C=6 Character color light grn. 
CHR$(154) C=7 Character color lt. blue 
CHR$(155) C=8 Character color 1t. gray 
CHR$(156) CTRL 5 Character color to purple 
CHR$(157) CRSR LEFT Cursor left one column 
CHR$(158) CTRL8 Character color to yellow 
CHR$(159) CTRL 4 Character color to cyan 
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C-64 COLOR 


The Commodore 64 offers the user a rainbow of sixteen 
colors. The screen, border, or character color may be 
changed to any of the sixteen hues. There are several 
options accessible, to the user, to alter color. The 
chart, on the next page, lists the attainable colors, 
plus the three modes available to change color on the 
Commodore 64. 


In the first column are the sixteen available colors. 
Many color combinations may be used, but some may be- 
come blurred when placed next to another. With trial 
and error, you will soon learn, which hues compliment 
each other. 


The second column, is the value to be added to a POKE 
command to change border, screen, or character color. 


EXAMPLE: POKE 53280,2 This command will change the 
border of the screen, to red. By changing the number 
after the comma, the border can be changed to any of 
the sixteen colors. POKE 53281,2 changes the entire 
screen to red, but not the border. 


The commands in column three ( labeled KEY ) are used 
to modify character color. The CONTROL and COMMODORE 
keys are found on the left hand side of the keyboard. 
To change the character color, hold down the CONTROL 
or COMMODORE LOGO key plus the number of the color at 
the same time. While in the quote mode, colors may be 
altered as often as needed. 


EXAMPLE: Press the CONTROL key and the number seven. 
From now, until another color command is entered, all 
characters will be in yellow. 


The fourth column displays the CHR$ value for each of 
the sixteen colors. The primary use for these, are to 
alter the character color within program code. 


EXAMPLE: CHR$(129) All characters will be printed to 
the screen in orange. 
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COLOR VALUE KEY CHR$ 
BLACK 0 CONTROL+1 CHR$(144) 
WHITE 1 CONTROL+2 CHR$(5) 
RED 2 CONTROL+3 CHR$( 28) 
CYAN 3 CONTROL+4 CHR$(159) 
PURPLE 4 CONTROL+5 CHR$(156) 
GREEN 5 CONTROL+6 CHR$(30) 
BLUE 6 CONTROL+7 CHR$(31) 
YELLOW 7 CONTROL+8 CHR$(158) 
ORANGE 8 COMMODORE+1 CHR$(129) 
BROWN 9 COMMODORE+2 CHR$(149) 
LIGHT RED 10 COMMODORE+3 CHR$(150) 
DARK GRAY 11 COMMODORE+4 CHR$(151) 
MED. GRAY 12 COMMODORE+5 CHR$(152) 
LIGHT GREEN 13 COMMODORE+6 CHRS$(153) 
LIGHT BLUE 14 COMMODORE+7 CHR$(154) 
LIGHT GRAY 15 COMMODORE+8 CHR$(155) 
SCREEN, BORDER, and CHARACTER COLOR 

Border color ......... 5 ioradtece e838 POKE 53280,value X 
Screen COLOK wisssscssccvvevvens POKE 53281,value X 
Character COlor ....icecccessves POKE 55296,value X 
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GRAPHIC SUMMARY 


The Commodore 64 has several types, of unique graphic 
features. Text may be displayed, in a rainbow of var- 
ious colors. Elaborate graphic images can be created 
by connecting letters, numbers, special symbols, and 
graphic characters of the three character sets. 


A second type of graphic display, is the bit-map mode 
for drawing intricate pictures and designs. Included 
in this category are both standard bit-map and multi- 
color bit-map mode. In the bit-map modes, you control 
each pixel, thus allowing great detail in your work. 


The third type of screen display, is a combination of 
text and bit-map graphics. This allows a split screen 
as you might see in an adventure game, picture at the 
top and text at the bottom. 


Another graphic feature is the sprite. A sprite is a 
movable graphic shape, designed by a user. The image 
may be animated, colored, or multi-colored. A sprite 
is 24 pixels wide X 21 pixels high in regular bit map 
mode, or 12 pixels wide X 21 high in multi-color bit 
map mode. 


IMPORTANT MEMORY LOCATIONS FOR GRAPHICS 





$0400 Start of screen memory 
$07E7 End of screen memory 
$D011 Bit map mode on or off 
Screen blanking on or off 
$D016 Multi-color mode on or off 
$D018 Location of screen memory 
$D018 Controls choice of character sets 


$D020 To change the color of the border 
$D021 To change the color of the screen 
$D7FF Start of color memory 

$D800 End of color memory 

$DCOE Turns interrupts on or off 

$DD00 Bank selection 
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C-—-64 SOUND 


The Commodore 64 is a musical wonder. The other day I 
listened to the thundering 1812 Overture (with cannon 
of course) played on a C-64. It was truly fantastic. 
A friend of mine says he can see the day when we att- 
end a concert of computers. I can envision 76 C-64's 
marching on parade. This might sound like a joke, but 
stop and think of the possibilities it presents. 


The chip that commands the sound for the C-64, is SID 
(Sound Interface Device). SID contains three separate 
registers { voices ). There are twenty five separate 
memory locations, that control these registers. Each 
of the three voices, have seven memory locations that 
control the type of sound produced by that voice. The 
following table, is read from left to right, starting 
with the memory location. 


64 SOUND REGISTERS 





54272-54278 VoOIce 1 








’ ADDRESS REGISTER DESCRIPTION 
54272 Lower half of tone frequency value 
54273 Upper half of tone frequency value 
54274 Lower half of pulse width value 
54275 Upper half of pulse width value 
54276 Waveform control register 
54277 Attack and Decay control register 
54278 Sustain/Release control register 





54279-54285 Voice 2 


54279 Lower half of tone frequency value 
54280 Upper half of tone frequency value 
54281 Lower half of pulse width value 
54282 Upper half of pulse width value 
54283 Waveform control register 

54284 Attack and Decay control register 
54285 Sustain/Release control register 
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54286-54292 voice 3 





54286 Lower half of tone frequency value 
54287 Upper half of tone frequency value 
54288 Lower half of pulse width value 
54289 Upper half of pulse width value 
54290 Waveform control register 

54291 Attack and Decay control register 
54292 Sustain/Release control register 





54293-54296 FILTERING 


§4293 Lower half of cutoff filter value 
54294 Upper half of cutoff filter value 
54295 Resonance/sound filtering values 

54296 Mode and volume controls 





The following chart illustrates octave, musical note, 
frequency produced, frequency produced by SID, high 
and low byte POKE values. Sid can produce sound waves 
at any frequency between 0 and 3995 hertz. This com- 
pares to about the same pitch range as a piano. 


64 MUSICAL NOTES 





OCTAVE MUSICAL FREQUENCY SID HIGH BYTE LOW BYTE 
NOTE PRODUCED FREQUENCY VALUE VALUE 





0 Cc 16.4 269 1 13 
0 C# 17.3 284 1 28 
0 D 18.4 302 1 46 
0 D# 19.4 318 1 62 
0 E 20.6 338 1 82 
0 F 21.8 358 1 102 
0 Fe 23.1 379 1 123 
0 G 24.5 402 1 146 
0 G# 26.0 427 1 171 
0 A 27.5 451 1 195 
0 At 29.1 477 1 221 
0 B 30.9 507 1 251 
a es 
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LL TTS LE SIE TE ST PES PEST ETE S 
OCTAVE MUSICAL FREQUENCY SID HIGH BYTE LOW BYTE 
NOTE PRODUCED FREQUENCY VALUE VALUE 





1 Cc 32.7 536 2 24 
1 C# 34.6 568 2 56 
1 D 36.7 602 2 90 
1 D# 38.9 638 2 126 
1 E 41.2 676 2 164 
1 F 43.7 717 2 205 
1 Fit 46.2 758 2 246 
1 G 49.0 804 3 36 
1 GH 51.9 851 3 83 
1 A 55.0 902 3 134 
1 At 58.3 956 3 188 
1 B 61.7 1012 3 244 
TEU 
2 Cc 65.4 1073 4 49 
2 C# 69.3 1137 4 113 
2 D 73.4 1204 4 180 
2 D# 77.8 1276 4 252 
2 E 82.4 1352 5 72 
2 F 87.3 1432 5 152 
2 F# 92.5 1517 5 237 
2 G 98.0 1608 6 72 
2 G# 103.8 1703 6 167 
2 A 110.0 1804 7 12 
2 A# 116.5 1911 7 119 
2 B 123.5 2026 Zc 234 
enn 
3 Cc 130.8 2146 8 98 
3 C# 138.6 2274 8 226 
3 D 146.8 2408 9 104 
3 D# 155.6 2553 9 249 
3 E 164.8 2703 10 143 
3 F 174.6 2864 11 48 
3 Fi 185.0 3035 11 219 
3 G 196.0 3215 12 143 
3 G# 207.7 3407 13 79 
3 A 220.0 3609 14 25 
3 A# 233.1 3824 14 240 
3 B 246.9 4050 15 210 
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SID 


HIGH BYTE LOW BYTE 


PRODUCED FREQUENCY VALUE 
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OCTAVE MUSICAL FREQUENCY SID HIGH BYTE LOW BYTE 
NOTE PRODUCED FREQUENCY VALUE VALUE 





7 Cc 2093.0 34334 134 30 
7 C# 2217.5 36377 142 25 
7 D 2349.3 38539 150 139 
7 D# 2489.0 40831 159 127 
7 E 2637.0 43258 168 250 
7 F 2793.8 45831 179 7 
7 F# 2960.0 48557 189 173 
7 G 3136.0 51444 200 244 
7 G# 3322.4 54502 212 230 
7 A 3520.0 57743 225 143 
7 A# 3729.3 61177 238 249 
7 B 3951.1 64815 253 47 





ATTACK, DECAY, RELEASE RATES 





VALUE ATTACK RATE DECAY/RELEASE RATE 





TIME CYCLE TIME CYCLE 
0 2 ms 6 ms 
1 8 ms 24 ms 
2 16 ms 48 ms 
3 24 ms 72 ms 
4 38 ms 114 ms 
5 56 ms 168 ms 
6 68 ms 204 ms 
7 80 ms 240 ms 
8 100 ms 300 ms 
9 250 ms 750 ms 
10 500 ms 1.5 8 
11 800 ms 2.48 
12 ls 3s 
13 3s 9s 
14 5s 15 s 
15 8s 24 s 
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C—-64 DISK COMMAND SUMMARY 


The commands listed below are used with the 1541 disk 
drive or the 1571 in C-64 mode. 
SSE aE IE ESE PE TER SOO I I ELITR 


CLOSE PRINT#15:CLOSE15 
To close channel that has been opened to receive data 


CMD CMD1 
To redirect screen output to a disk file. 


COPY PRINT#15,"C:new. file=old file" 
To make a copy (duplicate) of a file. 


GET # 
To read one byte from a record. 


INITIALIZE PRINT#15, "I" 
Returns the disk drive to power-up condition. 


INPUT# GET#5,a$ 
Reads a whole record from the disk. 


LOAD -c © e& e& e& ee © & © & & & @ 


LOAD"file name",8 Load a BASIC program. 
LOAD"*",8 | Load first program of DIR. 
LOAD"file name",8,1 Load machine language program. 
LOAD" file name",8,3 Automatic load and run. 


LOAD"$",8 Loads directory of disk. 

LOAD"A$",8 Loads contents of variable (A$) 

LOAD" T*",8 Loads first file beginning 
with 'T', 

LOAD" JAN*",8 Loads first file beginning 
with '"JAN', 


PRINT#15,"N:name,ID" To NEW a disk (format). 


PRINT#15, "N:name" To clear a directory. 
EEE TE ET ITE I CITES EN TRE TI EI IIE SIO IIE ITIP IIE EPID BEEING POSITED ESL 


“46-5 


(sz. ee fess UWEse' Ne Nees ees ee eS Y= Wo 


es, ieee: Hee We 














«-- C-64 MODE RED --> 





OPEN OPEN 15,8,15 
Opens a file or channel for input or output. 


PRINT# PRINT#5, p$ 
To output data to file or channel. 


RENAME PRINT#15,"Rsnew name=-old name" 
To rename a file on a diskette. 


SAVE SAVE"file name",8 
To SAVE a file in memory to disk. 


SAVE/REPLACE SAVE"@: file name",8 
To SAVE a new program and replace old. 


SCRATCH PRINT#15, "S: name" 
To erase (SCRATCH) a file. 


VALIDATE PRINT#15, *V" 
To re-organize or collect scattered blocks and make 
space available on the diskette. 


VERIFY VERIFY"file name",8 
To compare a saved file with one in memory 





ERROR CHANNEL To read the error channel, 
type the following: 
10 OPEN15,8,15 
20 INPUT#15,A$,B$,C$,D$ 
30 PRINT A$,B$,C$,D$ 
40 CLOSE 15 
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C-64 HANDY POKES and PEEKS 


The C-64 mode has 65,536 individual memory locations, 
each may store a number ranging from 0 to 255. A PEEK 
allows the user, to read the number stored at a given 
address. A POKE lets you write data into a RAM (Rand- 
om Access Memory ) location. ROM ( Read Only Memory ) 
may be read, but cannot be written to. POKE and PEEK 
commands may be used to extend your BASIC programming 
skills. As you can see, by the following chart, many 
useful and unusual things can take place. The list is 
just a beginning, explore other locations. You won't 
damage your computer, and you may learn a lot. 


POKE or PEEK ACTION 

POKE 1,0 Disable operating system. Default ,1 

POKE 19,65 Disable ? in input statement. Default 
value: 0 

POKE 22,35 LIST without line #'s. Default ,25 

PEEK 57 Number of the current BASIC line 

PEEK 59 Number of prior BASIC line 


POKE 120,0 Computer will go crazy. Default ,123 
POKE 145,127 Acts the same as the RUN/STOP key 


PEEK 152 Number of devices currently open 
PEEK 154 Output device number 

PEEK 187 Current open device number in use 
PEEK 197 Returns ASCII value of key pressed 


POKE 198,0 Clears the keyboard buffer 
POKE 199,1 Screen reverse off, 0 = on 


POKE 204 Cursor flash toggle, 1 = off,0 = on 
PEEK 206 Character under cursor in ASCII 

PEEK 209/210 Current screen line address 

PEEK 211 Cursor location on current line 
POKE 213 Screen line length, default: ,39 
PEEK 214 Current cursor position line number 
PEEK 243/244 Current screen color RAM location 
PEEK 646 Current character color value 

POKE 649 Size of keyboard buffer. Default:,10 


POKE 649,0 Disables keyboard. Default:,10 
POKE 650,0 Disables all keys, except cursor keys 
and space bar 


SA RS A TT OR ST RDA SDE ESET BSE TPR IS NO AE EO I EI 
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a EE LE ET ES a 


POKE or PEEK ACTION 

POKE 650,64 Disables all repeat of keys 

POKE 650,128 Makes all keys repeat 

POKE 657,1 Disables SHIFT & COMMODORE keys 

POKE 774,0 To vanish LISTing, leaves line #. 
Default value: ,26 

POKE 774,141 Listing vanishes. Default value: ,26 

POKE 775,168 To disable LIST. Prints ?UNDEF'D 
STATEMENT ERROR. Default: ,167 

POKE 775,171 To cause the computer to crash if a 
LIST attempt made. Default: ,167 

POKE 775,200 To disable LIST. Default: 775,167 

POKE 788,52 Disable RUN/STOP/TI$. Default: ,49 

POKE 792,193 Disable STOP/RESTORE. Default: ,71 

POKE 793,203 To disable RESTORE. Default: ,254 

POKE 808,127 Disables RUN. Default ,237 

POKE 808,225 Disable RUN/STOP/RESTORE, Default: , 237 

POKE 808,230 Disables proper listing. Default:,237 

POKE 808,232 Disables LIST/SAVE, program may not 
be stopped during run. Default: ,237 

POKE 808,234 Disables STOP/RESTORE/LIST. Default 
value: 237 

POKE 808,239 Disables RUN/STOP. Default: ,237 

POKE 818,32 Disables SAVE function. Default:, 237 

POKE 818,32 Press shifted RUN/STOP key, progran. 
in memory will auto run. Default 165 

POKE 816,157 Disables LOAD function. Default ,165 

POKE 819,246 Stops all attempts to SAVE. READY 
message is displayed. Default: ,245 

POKE 53265,11 For screen blanking. Saves run time. 
Default value: 27 

POKE 53269,0 Turns off sprites, saves 5% run time 

POKE 53272 ,2l = upper case ,23 = lower case 

POKE 53280 Screen border color 

POKE 53281 Screen color 

POKE 53296,1 Change operating speed from 1 MHZ to 
2 MHZ. Default value : ,0 

POKE 56325,X Changes cursor speed. 0 = fast, 
58 = normal, 255 = slow 

SYS 62913 Displays name of current file 
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¢-- C-64 MODE RED --> 


64 MODE MEMORY MAP 


The memory map of C-64 mode, is like 
a large filing cabinet. Imagine the 
memory locations, as single drawers, 
filled with information. The content 
of some of the drawers may be moved, 
modified, or read as is. A number of 
the drawers are locked, you can look 
but not make changes. By being aware 
of what is available, you can extend 
your programming skills. Remember, a 
computer can only do as you tell it. 


The subsequent pages contain a broad 
memory map for C-64 mode. All of the 
addresses are identified in hexadec- 
imal, decimal, and by label. This is 
followed by a description of how the 
data at this location is used by the 
computer. 
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<-- C-64 MODE RED --> 


C—64 MEMORY MAP 





HEX LABEL DECIMAL ACTION 





0000 D6510 
0001 R6510 


0002 ADRAY1 
0003 ADRAY1 
0005 ADRAY2 
0007 CHARAC 
0008 ENDCHR 
0009 TRMPOS 
000A VERCK 

000B COUNT 

000C DIMFLG 
000D VALTYP 
QOOE INTFLG 
OOOF GARBFL 
0010 SUBFLG 
0011 IMPFLG 
0012 TANSGN 
0013 CHANNL 
0014 LINNUM 
0016 TEMPPT 
0017 LASTPT 
0019 TEMPST 
0022 INDEX 

0024 INDEX 

0026 RESHO 

0028 TXTTAB 
002B VARTAB 
002F ARYTAB 
0031 STREND 
0033 FRETOP 
0035 FRESPC 
0037 MEMSIZ 
0039 CURLIN 
003B OLDLIN 
003D OLDTXT 
003F DATLIN 
0041 DATPTR 


Chip directional register 

Chip input/output, memory and 
tape control 

UNUSED 

Vector: floating point to integer 
Vector: integer to floating point 
Search character for BASIC text 
Scan end of string for quote flag 
Tab column save 

LOAD/VERIFY flag:0=LOAD, 1=VERIFY 
Input buffer pointer/# subscript 
Default array DIM flag 

Flag: type of data 

Flag: type of numeric data 

Flag: data scan LIST,quote marks 
Flag: subscript reference, FNX 
Flag: O=input, $40=GET, $98=READ 
Flag:TAN or SIN result comparison 
Flag: current input/output prompt 
Pointer: temporary string storage 
Pointer: temporary string stack 
Pointer: last temp. string vector 
Stack for temporary strings 
Pointer: for number transfer 
Miscellaneous number pointer 
Floating point area-mult./divide 
Pointer: start of BASIC text 
Pointer: start of BASIC variables 
Pointer: start of BASIC arrays 
Pointer: end of BASIC arrays 
Pointer: bottom of string storage 
Pointer: temporary for strings 
Pointer: limit of BASIC memory 
Pointer:current BASIC line number 
Pointer: prior BASIC line number 
Pointer: BASIC statement for cont 
Pointer: current data line number 
Pointer:address current data item 


RE SL BRE ROI I I AS I TIA A 
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TRIN EIT LE a ETE a TN TA EOI LES TT EE 


HEX LABEL DECIMAL ACTION 

IE DE AE AGREE SIE REIN ET PAT TET BP IE TELSTRA EL NIE FI OLCOTT, SERED TIE EEE RETRO SLED EEE OLE 
0043 INPPTR 67 Temp.storage while INPUT/GET/READ 
0045 VARNAM 69 Pointer: Current BASIC variable 
0047 VARPNT 71 Pointer: current BASIC var. data 
0049 FORPNT 73 Pointer: variable for FOR/NEXT 
004B OPPTR 75 Pointer: temporary data storage 
004D OPMASK 77 Comparison symbol accumulator 
O04E DEFPNT 78 Misc. work area, pointers etc. 
0050 DSCPNT 80 Pointer to string description 
0052 DSCPNT 82 Length of above string 
0053 FOURS 83 Constant used by garbage collect 
0054 JMPER 84 Jump vector for functions 
0057 TEMPF1 87 BASIC numeric work area 
005C TEMPF2 92 Temporary storage 





Memory location 00097 through 00112 are arguments for 
the floating-point arithmetic routines stored in the 
KERNAL ROM. They are central to the execution of any 
BASIC math operation. They also provide the assembly 
language programmer, the ability to perform any math 
operation on two numbers, without writing the BASIC 
routines. 
eee 
0061 FACEXP 97 Accumulator #1: exponent 

0062 FACHO 98 Accumulator #1: mantissa 

0066 FACSGN 102 Accumulator #1: sign 

0067 SGNFLG 103 Pointer: evaluation constant 

0068 BITS 104 Accumulator #1: overflow 

0069 ARGEXP 105 Accumulator #2: exponent 

006A ARGHO 106 Accumulator #2: mantissa 

O06E ARGSGN 110 Accumulator #2: sign 

OO06F ARISGN 111 Sign comparison result, math 

0070 FACOV 112 Accumulator #1 lo-order (rounding) 
0071 FBUFPT 113 Pointer: cassette buffer 

0073 CHRGET 115 CHRGET subroutine, get BASIC char 
007A TXTPTR 122 Pointer: curr. byte of BASIC text 
008B RNDX 139 RND function seed value 

0090 STATUS 144 Status word (ST) 

0090 144 Kernal work storage area 

0091 STKEY 145 Flag: has stop key been pressed? 


ES a RP TI I CI ES PE SR 
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STEER SE SS SP SE EE I LD 


HEX LABEL DECIMAL ACTION 


aE A SP IS TO TT TT 


0092 SVXT 
0093 VERCK 
0094 C3P0 
0095 BSOUR 
0096 SYNO 
0097 XSAV 
0098 LDTND 


Timing for tape 

Flag: load=0, verify=1 
Flag:serial bus, output char buff 
Buffered character for serial bus 
End of tape received 

Temporary X register save area 
Number of open files, maximum 10 
Input device, normally 0 

Default output (CMD) device 

Tape character output parity 
Flag: tape byte received 

Flag: display of error message 
Tape pass 1 error log/char buffer 
Tape pass 2 error log corrected 
Jiffy clock, hrs.,min.,sec. 
Temporary data storage 

Cycle count,serial input/output 
Countdown, tape write/bit count 
Pointer:# of char. in tape buffer 
RS-232 input bit storage 

RS-232 input bit count 

RS-232 flag:start bit error check 
RS-232 input byte buffer 

RS-232 input parity 

Pointer: tape buffer 

Pointer: tape, end address for 
LOAD, SAVE, VERIFY. 

Tape timing constants 
Pointer:address start/tape buffer 
RS-232 tape bit counter 

RS-232 bit to send/read or end 
RS-232 char. error/output buffer 
Number of char. in file name 
Current logical file number 
Current secondary address 

Current device number 

Pointer: current file name 

RS-232 output parity 

Cassette read/write block count 
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HEX LABEL DECIMAL ACTION 


ES PE ME TE SP a aT 


OOBF MYCH 
00CO CAS1 
00C1 STAL 


00C3 MEMUSS 
00C5 LSTX 
00C6 NDX 
00C7 RVS 


00Cc8 INDX 
00C9 LXSP 
00CB SFDX 
00CC BLNSW 
00CD BLNCT 
OOCE GOBLN 
OOCF BLNON 
00D0 CRSW 
00D1 PNT 
00D3 PNTR 
00D4 QTSW 
00DS LNMX 
00D6 TBLX 
00D7 SCHAR 
00D8 INSRT 
00D9 LDTB1 
00F2 

OOF3 USER 


OOFS KEYTAB 
OOF7 RIBUF 
0OF9 ROBUF 
OOFB FREKZP 
OOFF BASZPT 
0100 
0100-103E 
0100-01FF 
013F-01FF 
0200-0258 
0259 LAT 


191 
192 
193 


195 
197 
198 
199 


200 


256-318 
256-511 
319-511 
512-600 


601 


Tape input word buffer 

Cassette motor interlock 

Pointer: start address, cassette 
load and write 

Pointer: kernal setup 

Last key pressed 

# characters in keyboard buffer 
Flag: reverse char. MODE: 
normal=0, Value= 18 

Pointer: end of line for input 
Cursor log (row, column) 

Keyscan interrupt routine 

Flag: cursor blink, O=on, l=off 
Timer: cursor blink 

Character under cursor in ASCII 
Flag:last cursor blink on or off? 
Flag:input/get from scr./keyboard 
Pointer: current screen line add. 
Position of cursor on curr. line 
Flag: editor in quote mode, 0=off 
Current screen line length 
Current line where cursor is 
Temporary storage 

Flag: insert mode 

Screen line link table 

Screen row marker 

Pointer: to address of current 
screen color RAM 

Pointer: to keyboard decode table 
Pointer: RS-232 input buffer 
Pointer: RS-232 output buffer 
Four free bytes for ML routines 
BASIC temporary work area 
Floating point to ASCII work area 
Tape input error log 

6510 processor hardware stack 
BASIC stack area 

BASIC input buffer 

Logical file. number table 


a A RE RP AP OP GEIS ABE SR ISA AE LEP a SE La TT 
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HEX LABEL DECIMAL ACTION 


0263 


FAT 
SAT 
KEYD 
MEMSTR 
MEMSI2 
TIMOUT 
COLOR 
GDCOL 
HIBASE 
XMAX 
RPTFLG 
KOUNT 
DELAY 
SHFLAG 


LSTSHF 
KEYLOG 
MODE 

AUTODN 


611 
621 
631 
641 
643 
645 
646 
647 
648 
649 


Device numbers table 

Secondary active file add. table 
Keyboard buffer 

Pointer: start of BASIC memory 
Pointer: top of BASIC memory 
Flag: serial bus IEEE 

Current color code of character 
Color under cursor 

High byte screen memory address 
Maximum size of keyboard buffer 
Flag: repeat for keys 

Key repeat speed counter 
Counter for timing delay 

Flag: signals if SHIFT,CTRL, or 
COMMODORE LOGO key is pressed 
Last keyboard shift pattern 
Pointer: keyboard table setup 
Keyboard SHIFT mode 

Flag: screen scroll enabled 


** RS-232 PSEUDO 6551 REGISTERS ** 


M51CTR 
M51CDR 
M51AJB 
RSSTAT 
BITNUM 
BAUDOF 
RIDBE 

RIDBE 


RIDBS 


RODBS 
RODBE 


IRQTMP 


RS-232 mock 6551 control register 
RS-232 mock 6551 comm. registers 
RS-232 bit timing 

RS-232 status register 

RS-232 number of bits to send 
Time needed to send a bit 

Beg. & end of input/output buffer 
Pointer:to end of RS-232 256 byte 
recieve buffer 

Pointer: to start of RS-232 256 
byte receive buffer 

Pointer: to RS-232 output buffer 
Pointer:to end of RS-232 256 byte 
transmit buffer 

IRQ SAVE during tape input/output 
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HEX LABEL DECIMAL ACTION 





02A1 ENABL 
02A2 TODSNS 
02A3 TRDTMP 
02A4 TDIIRQ 
02A5 TLNIDX 
02A6 TVSFLG 
02A7-02FF 
0300-030B 
0300 IERROR 
0302 IMAIN 
0304 ICRNCH 
0306 IQPLOP 
0308 IGONE 
030A IEVAL 


030C 
030C SAREG 


030D SXREG 
030E SYREG 
030F SPREG 


0310 USRPOK 
0311 USRADD 
0313 

0314 CINV 
0316 CBINV 
0318 NMINV 


031A-032D 

031A IOPEN 

031C ICLOSE 
031E ICHKIN 
0320 ICKOUT 
0322 ICLRCH 
0324 IBASIN 
0326 IBSOUT 


673 
674 
675 
676 
677 
678 
679-767 
768-779 
768 
770 
772 
774 
776 
778 


780 
780 


781 
782 
783 


784 
785 
787 
788 
790 
792 


794-813 
794 
796 
798 
800 
802 
804 
806 


RS-232 interrupt enabled 

CIA #1 timer 

CIA #1 interrupt register B 

CIA #1 control register A 

Screen row marker 

Flag: for PAL or NTSC 

UNUSED 

BASIC indirect vector table 
Pointer:print BASIC error message 
Vector: BASIC warm start 

Vector: tokenize BASIC text 
Vector: prints tokens link list 
Vector: execute BASIC prog. token 
Vector: evaluates a single-term 
arithmetic expression 

Register storage area 

Temporary storage during SYS of 
A-register. 

Temporary storage during SYS of 
X-register. 

Temporary storage during SYS of 
Y-register. 

Temporary storage during SYS of 
.P-register. 

USR function, jump instructions 
High & low byte,USR start address 
UNUSED 

Vector:hardware interrupt address 
Vector: break instruction interr. 
Vector: Hardware Non-Maskable 
Interrupt (NMI) 

Kernal indirect vectors 

Vector: to kernal OPEN routine 
Vector: to Kernal CLOSE routine 
Vector: to Kernal CHKIN routine 
Vector: to Kernal CHKOUT routine 
Vector: to Kernal CLRCHN routine 
Vector: to Kernal CHRIN routine 
Vector: to Kernal CHROUT routine 





- 46 - 


foes, ke A 


(3! hese 


feet ee Te 


i 


Re 


[as AES. ee 














<-- C-64 MODE RED --> 


SEP BE IS EE TE 


HEX LABEL DECIMAL ACTION 


a EAP EEE SE IE I SST 


0328 ISTOP 
032A IGETIN 
032C ICLALL 
032E USRCMD 
0330 ILOAD 
0332 ISAVE 


033C TBUFFR 


0400 VICSCN 
O7F8 SPNTRS 


1000-1FFF 4096-8191 


8000 


A002 BWARM 
A004 

AQOC STMDSP 
A052 FUNDSP 
A080 OPTAB 
AOSE RESLST 
A19E 

A19E ERRTAB 


808 
810 
812 
814 
816 
818 
820 


Vector: to Kernal STOP routine. 
Get vector. 

Abort input/output vector. 
Warm start vector. 

LOAD link. 

Vector: to Kernal SAVE routine. 
UNUSED-8 bytes free 


828-1019 Cassette input/output buffer 


2040 


32768 
36864 
40960 
40960 
40962 
40964 
40972 
41042 
41088 
41118 
41374 
41374 
41390 
41398 
41414 
41422 
41446 
41462 
41478 
41494 
41510 
41526 
41534 
41550 


Sprite 13 

Sprite 14 

Sprite 15 

UNUSED 

Vid. matrix 25 line X 40 column 
Pointer: sprite shape data 
Character ROM image 

Autostart ROM cartridge 

Char. ROM image, VIC II chip 
Vector: warm start 

ROM: BASIC interpreter or 8K/RAM 
Vector: warm start 

ASCII Text characters CBM BASIC 
Dispatch vector table,statement 
Dispatch vector table, function 
Dispatch vector table, operator 
Keyword table 

ASCII text,BASIC error messages 
BASIC error message #1 


‘BASIC error message #2 


BASIC error message #3. 
BASIC error message #4 
BASIC error message #5 
BASIC error message #6 
BASIC error message #7 
BASIC error message #8 
BASIC error message #9 
BASIC error message #10 
BASIC error message #11 
BASIC error message #12 
BASIC error message #13 


SE NE EE 20 ET STS AA I TE 
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HEX LABEL DECIMAL ACTION 


A25E 
A26E 
A276 
A27E 
A296 
A29E 
A2AE 
A2BE 
A2CE 
A2D6 
A2EE 
A2F6 
A306 
A30E 
A31E 
A326 
A328 
A365 
A38A 
A3B8 


A65E 
A68E 
A69C 


ERRPTR 


FNDFOR 
BLTU 
GETSTK 
REASON 
OMERR 
ERROR 


READY 


MAIN 
MAIN1 


LINKPRG 
INLIN 
CRUNCH 
FNDLIN 
SCRTCH 
CLEAR 
RUNC 
LIST 


41566 
41582 
41590 
41598 
41622 
41630 
41646 
41662 
41678 
41686 
41710 
41718 
41734 
41742 
41758 
41766 
41768 
41829 
41866 
41912 
41979 
41992 
42037 
42039 
42089 
42100 
42110 
42112 
42140 
42153 
42221 
42291 
42336 
42361 
42515 
42562 
42590 
42638 
42652 


BASIC error message #14 

BASIC error message #15 

BASIC error message #16 

BASIC error message #17 

BASIC error message #18 

BASIC error message #19 

BASIC error message #20 

BASIC error message #21 

BASIC error message #22 

BASIC error message #23 

BASIC error message #24 

BASIC error message #25 

BASIC error message #26 

BASIC error message #27 

BASIC error message #28 

BASIC error message #29 

Error message vector table 
BASIC interpreter messages 
Stack routine, GOSUB/FOR-NEXT 
Checks for free memory 

Test for stack depth 

Check available space in memory 
Out of memory error handler 
General error handler 

Prints error or break message 
Prints the message READY 
New BASIC line processing 
Main BASIC program loop 

Add or replace line of text 
Erase program line 

Insert program line 

BASIC line chaining 

Receive line from the keyboard 
Tokenize BASIC line 

Search for line number 
Perform BASIC command NEW 
Perform BASIC command CLR 
Reset BASIC to start of program 
Perform BASIC command LIST 


EL TTP II TN TT ST I EP Soe IS IE TET CE ETI 
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<-- C-64 MODE RED --> 


ACTION 
Perform BASIC command FOR 

Set up next statement 
Execute next BASIC statement 
Perform BASIC command 
Test STOP key 


HEX LABEL DECIMAL 


FOR 
NEWSTT 
GONE 
RESTOR 


STOP 
END 
CONT 
RUN 
GOSUB 
GOTO 
RETURN 
DATA 
DATAN 


PRINTN 
CMD 
PRINT 
STROUT 


DOAGIN 
GET 
INPUTN 
INPUT 
QINLIN 
READ 
EXIGNT 
NEXT 


FRMNUM 
CHKSTR 
FRMEVL 
EVAL 
PIVAL 


42818 
42926 
42980 
43037 
43052 
43055 
43057 
43095 
43121 
43139 
43168 
43218 
43256 
43270 
43273 
43304 
43323 
43339 
43371 
43429 
43648 
43654 
43680 
43806 
43835 
43853 
43899 
43941 
43967 
44025 
44038 
44284 
44318 
44408 
44426 
44431 
44446 
44675 
44712 


Per form 
Per form 
Per form 
Perform 
Per form 
Per form 
Per form 
Perform 


BASIC 
BASIC 
BASIC 
BASIC 
BASIC 
BASIC 
BASIC 
BASIC 


Scan for next 
Scan for next 


Per form 
Per form 


BASIC 
BASIC 


command 
command 
command 
command 
command 
command 
command 
command 


RESTORE 


STOP 
END 
CONT 
RUN 
GOSUB 
GOTO 
RETURN 
DATA 


statement 


line 
command 
command 


Perform ON GOTO or ON 
Get integer from text 
Perform BASIC command 
Perform BASIC command 
Perform BASIC command 
Perform BASIC command 
Print string from any 


Print format character 


Process bad input 
Perform BASIC commands GET/GET# 
Perform BASIC command INPUT# 

Perform BASIC command INPUT 

Prompt and input 
Perform BASIC command READ 
Input error messages 
Perform BASIC command NEXT 
Type match check 
Evaluate numeric expression 
Check input was a string 

Evaluate expression 
Convert single arithmetic term 
Constant - PI 
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Pe a 


HEX LABEL DECIMAL ACTION 

SS ETS ET I PT ERT TE TIE EE DOT I ETP TS TT EE TE TEES 

AEF1 PARCHK 44785 Evaluate within brackets 

AEF7 CHKCLS 44791 Check for ")" 

AEFA CHKOPN 44794 Check for "(" 

AEFD 44797 Check for "-" 

AEFF CHKOPN 44799 Check for "," 

AFO8 SNERR 44808 Prints SYNTAX error 

AF14 RSVVAR 44820 Checks for variable name 

AF2B ISVAR 44843 Get the value of a variable 

AFA7 ISFUN 44967 Set up function references 

AFE6 OROP 45030 Perform BASIC command OR 

AFES ANDOP 45033 Perform BASIC command AND 

B016 DORE] 45078 Comparison routine for <,),= 

B081 DIM 45185 Perform BASIC command DIM 

BO8B PTRGET 45195 Locate variable area 

BOE7 45287 Find variable, return location 

B113 45331 Check .A register for alpha 
ASCII character 

B1l1D NOTFNS 45341 Create new space 

B185 FINPTR 45445 Return address of variable found 

B194 ARYGET 45460 Pointer: array routine 

B1A5 N32768 45477 32768 in Floating Point format 

B1AA FACINX 45482 Convert Floating Point number 

B1B2 INTIDX 45490 Input/convert a Floating Point 
subscript to positive integer 

BIBF AYINT 45503 FAC #1 to integer 

B1D1 ISARY 45521 Find or create array 

B245 BSERR 45637 Print bad subscript error mess. 

B248 FCERR 45640 Print illegal quantity err. mess. 

B34C UMULT 45900 Compute array size 

B37D FRE 45949 Perform BASIC function FRE 

B391 GIVAYF 45969 Convert 16-bit signed integer 
to Floating Point... 

B39E POS 45982 Perform BASIC command POS 

B3A6 ERRDIR 45990 Test for direct mode 

B3B3 DEF 46003 Perform BASIC command DEF 

B3E1 GETFNM 46049 Check for function syntax 

B3F4 FNDOER 46068 Evaluate BASIC command function 

B465 STRD 46181 Perform BASIC command STR$ 

B475 STRINI 46197 String administration 
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HEX LABEL DECIMAL ACTION 


B487 STRLIT 
B4F4 GETSPA 
B526 GARBAG 
B5BD DVARS 


B63D CAT 
B67A MOVINS 
B6A3 FRESTR 
B6BD FRETMS 
B6EC CHRD 
B700 LEFTD 
B72C RIGHTD 
B737 MIDD 
B761 PREAM 


B77C LEN 
B782 LEN1 
B78B ASC 
B79B GETBYTC 


B7AD VAL 
B7B5 STRVAL 


B7EB GETNUM 
B7F7 GETADR 
B80D PEEK 
B824 POKE 
B82D FUWAIT 
B849 FADDH 
B850 FSUB 
B853 FSUBT 
B867 FADD 
B86A FADDT 
B8A7 FADD4 
B8FE NORMAL 
B947 NEGFAC 
B97E OVERR 


46215 
46324 
46374 
46525 
46598 
46653 
46714 
46755 
46811 
46828 
46848 
46892 
46903 
46945 


46972 
46978 
46987 
47003 
47006 


47021 
47029 
47031 


47083 
47095 
47117 
47140 
47149 
47177 
47184 
47187 
47207 
47210 
47271 
47358 
47431 
47486 


Set up string 

Make room for strings 
Collect garbage 

Check for eligible strings 
Collect string 

Concatenate two strings 
Build string to memory 
Discard unwanted string 
Clean the discriptor stack 
Perform BASIC command CHR$ 
Perform BASIC command LEFTS 
Perform BASIC command RIGHTS 
Perform BASIC command MID$ 
Pull string parameters from 
the stack 

Perform BASIC command LEN 
Exit string mode 

Perform BASIC command ASC 
Input byte parameters 

Place 1 byte from BASIC text 
in X-register 

Perform BASIC command VAL 
ASCII to FAC #1 

Converts FAC #1 to a two byte 
unsigned integer at $14 

Get POKE/WAIT parameters 

FAC #1 to an interger 
Perform BASIC command PEEK 
Perform BASIC command POKE 
Perform BASIC command WAIT 
Add 0.5 to FAC #1. 

Number in memory minus FAC #1 
Perform subtraction 

Number in memory plus FAC #1 
Perform addition 

Make result negative 
Normalize FAC #1 

Complement FAC #1 

Print overflow error message 


a NI 
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HEX LABEL DECIMAL ACTION 


EES SA PS TEE IO TE OO TE GE TED 


B983 MULSHF 
B9BC FONE 
B9C1 LOGCN2 
BSEA LOG 
BA28 FMULT 
BA30 FMULT 
BA33 FMULT 
BA59 MLTPLY 
BA8C CONUPK 
BAB7 MULDIV 
BAD4 MLDVEX 
BAE2 MUL10 
BAF9 TENC 


BAFE DIV10 


BBOF FDIV 
BB12 FDIVT 
BBA2 MOVFM 


BBC7 MOV2F 


BBFC MOVFA 
BCOC MOVFA 


BCOF MOVFA 
BC1B ROUND 
BC2B SIGN 
BC39 SGN 
BC58 ABS 
BC5B FCOMP 
BC9B QINT 
BcCC INT 
BCF3 FIN 


BD7E FINLOG 


47491 
47548 
47553 
47594 
47656 
47664 
47667 
47705 
47756 
47799 
47828 
47842 
47865 


47870 
47879 
47887 
47890 
48034 


48071 


48087 
48124 


48140 


48143 
48155 
48171 
48185 
48216 
48219 
48283 
48332 
48371 


48510 


Single byte multiply 

Floating point constants 

FAC table for log functions 
Perform BASIC command LOG 
Multiply FAC #1 by memory. 
Multiply FAC #2 by FAC #1. 
Multiply FAC # 1 by FAC #2 
Multiply a bit subroutine 
Memory to FAC #2 

Adjust FAC #1 & #2 

Handle under flow/overflow 
Multiply FAC #1 by 10. 
Constant 10 in five-byte 
floating format 

Divide FAC #1 by 10. 

Divide FAC #2 by 10 

Divide a # in memory by FAC #1 
Divide FAC #2 by FAC #1. 

Move a floating point number 
from memory to FAC #1 

Move a floating point number 
from FAC #1 to memory. 

FAC #1...to memory. 

Move a floating point number 
from FAC #2 to FAC #1 

Round and move a floating point 
number from FAC #1 to FAC #2 
FAC #1 to FAC #2, no rounding 
Round off FAC #1. 

Find sign of FAC #1 

Perform BASIC command SGN 
Perform BASIC command ABS 
Compare FAC #1, to memory. 
Convert FAC #1...to integer 
Perform BASIC command INT 
Convert ASCII string to floating 
point # in FAC #1. 

Add an ASCII digit to FAC #1 


CER RTS TB IT ET IPT IE LHL EZ SS SA BEE LEE ES 
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(-- C-64 MODE RED --> 


HEX LABEL DECIMAL ACTION 


BDB3 N0999 48563 Constants table for ASCII string 
conversion. 

BDCO INPRT 48576 Print 'IN' followed by a line # 

BDCD LINPRT 48589 Output # in ASCII decimal digits 

BDD7 FACOUT 48599 Print FAC #1, as an ASCII string 

BDDD FOUT 48605 Convert contents of FAC #1 to an 
ASCII string 

BF1l FHALF 48913 More constants for rounding/SQR 

BF1C FOUTB 48924 Powers of - 10 constants table 

BF3A FDCEND 48954 Table of constants, TI$ to ASCII 

BF52 48978-49008 UNUSED AREA 

BF71 SQR 49009 Perform BASIC command SQR 

BF75 FPWRT 49013 Replace FAC #1 with FAC #2 

IF7B FPWRT 49019 Perform exponentiation 

BFB4 NEGOP 49076 Perform negative statement NOT 

BFBF EXPCON 49087 Constant table - EXP/LOG routines 

BFED EXP 49133 Perform BASIC command EXP 

COOO-CFFF 49152-53247 4K FREE RAM, not for BASIC 
programs 


DOOO-DFFF 53248-57343 

4K MEMORY BLOCK...normal functions are: two Complex 
Interface Adapter (CIA) Input/Output chips, VIC-IT 
video controller chip, Sound Interface Device (SID), 
and color RAM. 


DO00-DO2ZE 53248-53294 

MOS 6566 VIDEO INTERFACE CONTROLLER (VICII) generates 
video signals for the display of sprites, text, 
color, multicolor, bitmap graphics, etc. 


D000 SPOX 53248 Sprite 0 horizontal (X) position 
D001 SPOY 53249 Sprite 0 vertical (Y) position 
DOO2 SP1X 53250 Sprite 1 horizontal (X) position 
D003 SP1Y 53251 Sprite 1 vertical (¥) position 
D004 SP2x 53252 Sprite 2 horizontal (X) position 
D005 SP2y 53253 Sprite 2 vertical (Y) position 
D006 SP3X 53254 Sprite 3 horizontal (X) position 
D007 SP3Y 53255 Sprite 3 vertical (¥) position 
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<-- C-64 MODE RED --> 


HEX LABEL DECIMAL ACTION 


D008 SP4x 
DOOS SP4Y 
DOOA SP5X 
DOOB SP5Y 
DOOC SP6xX 
DOOD SP6Y 
DOOE SP7X 
DOOF SP7Y 
D010 MSIGX 


D011 SCROLY 
D012 RASTER 


DO20 EXTCOL 
D021 BGCOLO 
D022 BGCOL1 
D023 BGCOL2 
DO24 BGCOL3 
D025 SPMCO 

D026 SPMC1 

D027 SPOCOL 
D028 SP1COL 
D029 SP2COL 
DO2A SP3COL 
DO02B SP4COL 
DO2C SP5COL 
D02D SP6COL 
DO2E SP7COL 


D040-D3FF 


53256 
53257 
53258 
53259 
53260 
53261 
53262 
53263 
53264 


53265 
53266 


53280 
53281 
53282 
53283 
53284 
53285 
53286 
53287 
53288 
53289 
53290 
53291 
53292 
53293 
53294 


Sprite 
Sprite 


4 horizontal (X) position 
4 vertical (Y) position 
Sprite 5 horizontal (X) position 
Sprite 5 vertical (Y) position 
Sprite 6 horizontal (X) position 
Sprite 6 vertical (Y) position 
Sprite 7 horizontal (X) position 
Sprite 7 vertical (Y) position 
Sprites 0-7 most significant bits 
horizontal positions 

Cont. reg. vertical fine scroll 
Read/write current raster scan 
line, compare of raster IRQ 
Border color 

Background color 0: screen color 
Background col.1: char.multicol.1 
Background col.2: char.multicol.1 
Background color 3 

Sprite multicolor register 0 
Sprite multicolor register 1 
Sprite 0 color register 


Sprite 1 color register 
Sprite 2 color register 
Sprite 3 color register 
Sprite 4 color register 
Sprite 5 color register 
Sprite 6 color register 


Sprite 7 color register 


53295-53311 Not connected 
53312-54271 Vic-II register images 


** MOS 6581 SOUND INTERFACE DEVICE (SID) ** 


D400 FRELO1 
D401 FREHI1 
D402 PWLO1 

D404 VCREG1 
D405 ATDCY1 
D406 SUREL1 


54272 
54273 
54274 
54276 
54277 
54278 


Voice 1:frequency cont.(low byte) 
Voice 1:frequency cont. (hi. byte) 
Voice 1: pulse waveform width 
Voice 1: control register 
Envelope gen. l:attack/decay 
Envelope gen.1i:sustain/release 


Gee Mose? eS SS; ee es ee (eS iS eS te. Oe Se 
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(-- C-64 MODE RED --> 


HEX LABEL DECIMAL ACTION 


D407 FRELO2 54279 Voice 2: frequency - low byte 
D408 FREHI2 54280 Voice 2: frequency - high byte 
D409 PWLO2 54281 Voice 2: pulse waveform-low byte 
D40A PWHI2 54282 Voice 2: pulse waveform-high byte 
D40B VCREG2 54283 Voice 2: control register 
D40C ATDCY2 54284 Envelope generator 2:attack/decay 
D40D SUREL2 54285 Envelope gen. 2:sustain/release 
D40E FRELO3 54286 Voice 3: frequency - low byte 
D40F FREHI3 54287 Voice 3: frequency - high byte 
D410 PWLO3 54288 Voice 3: pulse waveform-low byte 
D411 PWHI3 54289 Voice 3: pulse waveform-high byte 
D412 VCREG3 54290 Voice 3: control register 
D413 ATDCY3 54291 Envelope gen. 3: attack/decay 
cycle control 
D414 SUREL3 54292 Envelope gen. 3: sustain/release 
cycle control 
D415 CUTLO 54293 Filter cutoff freq.:low nibble 
D416 CUTHI 54294 Filter cutoff frequency:high byte 
D417 RESON 54295 Filter resonance/voice input con. 
D418 SIGVOL 54296 Select filter mode and volume 
D419 POTK 54297 Analog/digital converter:paddle 1 
D41A POTY 54298 Analog/digital converter:paddle 2 
D41B RANDOM 54299 Oscillator 3: random # generator 
D41C ENV3 54300 Envelope generator 3 output 
D41D-D41F 54301-54303 Not connected 
D420-D7FF 54304-55295 Sid images 
D800-DBFF 55296-56319 Color RAM: fixer location 


** MOS 6526 COMPLEX INTERFACE ADAPTER (CIA) #1 ** 


DCOO CIAPRA 56320 Data port A:joystick,keyboard,ect 
DCO1 CIAPRB 56321 Data port B:joystick,keyboard,ect 
DCO2 CIDDRA 56322 Data direction register:port A 
DCO3 CIDDRB 56323 Data direction register:port B 
DCO4 TIMALO 56324 Timer A: low byte 

DCO5 TIMAHI 56325 Timer A: high byte 

DCO6 TIMBLO 56326 Timer B: low byte 

DCO7 TIMBHI 56327 Timer B: high byte 

DCO8 TODTEN 56328 Time of day clock: 1/10 seconds 
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HEX LABEL DECIMAL ACTION 


DCO9 TODSEC 56329 Time of day clock: seconds 

DCOA TODMIN 56330 Time of day clock: minutes 

DCOB TODHRS 56331 Time of day clock: hours & AM/PM 
DCOC CIASDR 56332 Serial data port 

DCOD CIAICR 56333 Interrupt control register 

DCOE CIACRA 56334 Control register A 

DCOF CIACRB 56335 Control register B 

DC1O-DCFF 56336-56575 CIA #1 register images 


** MOS 6526 COMPLEX INTERFACE ADAPTER (CIA) #2 ** 


DDOO C12PRA 56576 Data port A (serial bus, RS-232) 

DDO1 C12PRB 56577 Data port B (user port, RS-232) 

DDO2 C2DDRA 56578 Data direction register: port A 

DDO3 C2DDRB 56579 Data direction register: port B 

DD04 TI2ALO 56580 Timer A: low byte 

DDO5 TI2AHI 56581 Timer A: high byte 

DDOG TI2BLO 56582 Timer B: low byte 

DDO7 TI2BHI 56583 Timer B: high byte 

DDO8 TO2TEN 56584 Time of day clock: 1/10 seconds 

DDO9 TO2SEC 56585 Time of day clock: seconds 

DDOA TO2MIN 56586 Time of day clock: minutes 

DDOB TO2HRS 56587 Time of day clock: hours & AM/PM 

DDOC CI2SDR 56588 Synchronous serial input output 
buffer 

DDOD CI2ICR 56589 CIA interrupt control register 

DDOE CI2CRA 56590 CIA control register A 

DDOF CI2CRB 56591 CIA control register B 

DD10-DDFF 56592-56831 CIA #2 register images 

DEOQO-DEFF 56832-57087 Reserved for future expansion 

DFOO-DFFF 57088-57343 Reserved for future expansion 


Location 57344 to 65535 (E000 - FFFF) are used by the 
8K operating system Kernal ROM. Kernal ROM is subject 
to revision (by the manufacturer), these routines may 
not stay at the same address. It is recommended that 
the user refer to the 'JUMP TABLE' at the end of ROM. 
By having the program 'jump' to a ROM addresse in the 
TABLE, it should run without change on future models. 
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<«-- C-64 MODE RED --> 


HEX LABEL DECIMAL ACTION 


SS I SE a TE EN 


E000 


POLY1 
POLY2 
RMULC 
RADDC 
RND 


SYS 
SAVE 
VERIFY 
LOAD 


OPEN 
CLOSE 


cos 
SIN 


TAN 


PI2 
TWOPI 


FR4 


SINCON 


ATN 
ATNCON 


INITAT 


57344 
57411 
57433 
57485 
57490 
57495 
57593 
57642 
57686 
57701 
57704 
57790 
57799 
57812 
57856 
57862 


57870 
57881 
57956 
57960 
57963 
58036 
58039 
58080 
58085 


58090 


58095 


58125 
58126 
58174 
58235 
58251 
58260 
58274 
58298 


Continuation of EXP routine 
Evaluation of complex expressions 
Main series evaluation routine 
Multiplicative constant for RND 
Additive constant for RND 
Perform the BASIC command RND 
Call kernal input/output routines 
Perform the BASIC command SYS 
Perform the BASIC command SAVE 
Perform the BASIC command VERIFY 
Perform the BASIC command LOAD 
Perform the BASIC command OPEN 
Perform the BASIC command CLOSE 
Set parameters, LOAD, VERIFY, SAVE 
Skip comma and get integer in .X 
Get current character and check 
for end of line 

Check for comma 

Set parameters for OPEN and CLOSE 
Perform the BASIC command COS 
Perform the BASIC command SIN 
FAC 1=SIN (FAC 1) 

Perform the BASIC command TAN 
FAC 1=TAN (FAC 1) 

Constants for trig functions 

5 byte floating point rep. of 
constant 2*PI 

5 byte floating point rep. of 
constant 1/4 

Table of constants for eval. of 
SIN,COS, TAN 

FAC 1=ATN (FAC 1) 

Perform the BASIC command ATN 
Constants for ATN 

Warm start BASIC 

Error message handler 

Cold start BASIC 

Character get for zero page 
Initial RND seed value 


SAS A RE TS ST EA ES SIS, 


- 57 - 


«-- C-64 MODE RED --> 


Sa EZ EE EE TE TS EE A SE 


HEX LABEL DECIMAL ACTION 


RA I ITP EE EI TER ER TIE ES ET EE EEE 


E3BF 
E422 
E447 


E453 
E460 
E4AD 
E4B7 
E4DA 
E4E0 
E4EC 
E000 
E505 
E50A 
E518 
E531 
E544 
E566 
E56C 
E5A0 
E5A9 
E5B4 
ESCA 
E632 
E684 
E691 
E6A8 


E6B6 
E6F7 
E701 
E716 
E87C 
E891 


INIT 


WORDS 


IOBASE 
SCREEN 
PLOT 
CINT 


NXTD 
STUPT 
PANIC 


LP2 

KBINP 
KSINP 
QTSWC 
SCPUT 


SCNPNT 


CKDECL 
CKINL 

CKCOLR 
CKDECL 


58303 
58402 
58439 


58451 
58464 
58541 
58551 
58586 
58592 
58604 
58624 
58629 
58634 
58648 
58673 
58692 
58726 
58732 
58784 
58792 
58804 
58826 
58930 
59012 
59025 
59048 


59062 
59127 
59137 
59158 
59516 
59537 
59553 
59571 
59595 
59601 
59618 


Initialize BASIC 

Print BASIC start-up messages 
Table of vectors to important 
BASIC routines 

Copy BASIC vectors to RAM 
Power up messages 

Program patch area 

UNUSED 35 bytes free 

Clear color RAM 

Pause when file found on cassette 
Baud rate table for european(PAL) 
Get input output address 

Set screen limits 

Track cursor location 
Initialize input output 
Normalize screen 

Clear screen 

Home the cursor 

Set screen pointers to cur. line 
Set input output defaults 

Set VIC chip defaults 

Get input from keyboard 

Wait for carriage return 
Input from screen or keyboard 
Quote mark test 

Set up screen print 

Return from outputting a char. 
to the screen 

Advance the cursor 

Retreat the cursor 

Back into previous line 
Output to screen 

Cursor goto next line 
Carriage return 

Check line decrement 

Check line increment 

Set color code 

Color code table 

Code conversion 
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<-- C-64 MODE RED --> 


HEX LABEL DECIMAL ACTION 


nen 


E8EA SCROL 59626 


E965 59749 
E9C8 59848 
E9EO 59872 
E9FO 59888 


E9FF CLRLN 59903 
EA13 DSPP 59923 
EAIC 59932 
EA24 59940 
EA31 KEY 59953 
EA87 SCNKEY 60039 


EAEO 60128 
EB48 60232 
EB59 60249 
EB79 KEYCOD 60281 
EB81 60289 
EB91 60305 
EBC2 60354 
ECO3 60419 
EC44 60484 
EC4F 60495 
EC5E 60510 
EC78 60536 
ECB9 60601 
ECE7 60647 
ECFO 60656 


EDO9 TALK 60681 
EDOC LISTEN 60684 


ED11 60689 
ED40 60736 
EDBO 60848 
EDB9 SECOND 60857 
EDBE 60862 
EDC7 TKSA 60871 
EDDD 60893 


EDEF UNTLK 60911 
EDFE UNLSN 60926 
EE13 ACPTR 60947 
EE85 61061 


Scroll screen 

Open space on screen 

Move screen line 

Synch color transfer 

Set start of line 

Clear screen line 

Print to screen 

Store on screen 

Synch color to character 
Interrupt (IRQ) 

Check keyboard 

Decode keystroke 

Set up keyboard decode table 
Set text mode 

Keyboard vectors 

Keyboard 1 - unshifted 
Keyboard maps 

Keyboard 2 - shifted 
Keyboard 3 - logo key shifted 
Graphics/text control 

Set graphics mode 

Check for special characters 
PET ASCII table for keyboard 
Video chip default 

Shift/run equivalent 

Low byte table scr. line sdaress 
Send ‘'TALK' 

Send 'LISTEN' 

Send control character 

Send to serial bus 

Time out on serial 

Send listen SA 

Clear ATN 

Send SA to device after talk 
Send byte to I/O device 

Send 'UNTALK' to device 

Send 'UNLISTEN' to device 
Receive a byte from device 
Set serial clock line low (on) 
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HEX LABEL DECIMAL ACTION 


EN RL I a cE EE TE I IS 


EE8E 
EE97 
EEAO 
EEA9 
EEB3 
EEBB 
EF06 
EF 2E 
EF3B 
EF4A 
EF59 
EF7E 
EF90 
EF97 
EFC5 
EFCA 
EFCD 
EFDO 
EFE1 
FOOD 
F017 
F04D 
F086 
FOA4 
FOBD 
F12B 
F13E GETIN 
F14E 
F157 CHRIN 
F199 
F1CA CHROUT 
F1CA 
F1DD 
F20E CHKIN 
F250 CHKOUT 
F291 CLOSE 
F30F 
F31F 
F32F CLALL 


ee A EP TP ET a TT 


61070 
61079 
61088 
61097 
61107 
61115 
61190 
61230 
61243 
61258 
61273 
61310 
61328 
61335 
61381 
61386 
61389 
61392 
61409 
61453 
61463 
61517 
61574 
61604 
61629 
61739 
61758 
61774 
61783 
61849 
61898 
61909 
61917 
61966 
62032 
62097 
62223 
62239 
62255 


Set serial clock line high (off) 
Set serial bus output line low 
Set serial bus output high 

Get serial bus input and clock 
Delay of 1 MS. 

Send next RS-232 bit NMI 

Send new RS-232 byte 

Handle RS-232 errors 

Disable timer 

Compute word length/RS-232 char. 
Receive next RS-232 bit NMI 

Set up to receive new byte/RS-232 
Test if above byte received 

Put byte in RS-232 receive buffer 
Receive parity error 

Receive overrun error 

Receive break error 

Receive frame error 

CHKOUT for the RS-232 device 

No DSR error 

Send to RS-232 buffer 

Input from RS-232 buffer 

Get from RS-232 buffer 

Check serial bus, see if idle 
Kernal control messages 

Print kernal error messages 

Get 1 byte from input device 

.. from RS-232 

Input byte from current device 
Get byte from tape/serial/RS-232 
Output a byte 

Output 

To tape..... 

Set input device 

Set output device 

Close a logical input/output file 
Find file in logical file table 
Set file values 

Abort all files 
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«-- C-64 MODE RED --> 


HEX LABEL DECIMAL ACTION 
EIA ET IE I SS IS EE RTI OE TE I EE EP ISTI 


F333 CLRCHN 
F34A OPEN 


F5DD SAVE 
F68F 

F69B UDTIM 
F6BC 

F6DD RDTIM 
F6E4 SETTIM 
F6ED STOP 


62259 
62282 
62421 
62473 
62622 
62885 
62904 
62930 
62941 
63119 
63131 
63164 
63197 
63204 
63213 
63227 
63276 
63338 
63440 
63447 
63466 
63501 
63511 
63534 
63544 
63553 
63588 
63605 
63696 
63714 
63788 
64096 
64398 
64407 
64422 
64456 
64461 
64599 
64618 


Restore default input/output 
Do file opening 

Send SA 

Open RS-232 

Load program from device 
Print 'SEARCHING' message 
Print file name 

Print "LOADING or VERIFY' 
Save PROGRAM to device 

Print 'SAVING' and filename 
Updata software clock 

Log PIA key reading 

Read time from software clock 
Set the software clock 

Test STOP key 

File error messages 

Find any tape header 

Write tape file header 

Get tape buffer address 

Set tape buffer start/end pointer 
Find specific header 

Bump tape pointers 

Print message 'PRESS PLAY' 
Check cassette status 

Print message 'PRESS RECORD' 
Initiate tape read 

Initiate tape write 

Common tape read/write 

Check STOP during tape functions 
Adjust tape bit timing 

Read tape data 

Store next character from tape 
Reset pointer 

New tape character setup 
Toggle tape data output line 
Write data to cassette 

Tape write (IRQ) 

Header write (IRQ) 

Write data to cassette 
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HEX LABEL DECIMAL ACTION 


PE a EE TE BE ET BEI EE I ET SoA OT TEN TL CIEE ITED, 


FC93 
FCB8 
FCCA 


RESTOR 
VECTOR 


RAMTAS 


IOINIT 


SETNAM 
SETLFS 
READST 
SETMSG 
SETTMO 
MEMTOP 
MEMBOT 


CINT 


64659 
64696 
64714 
64721 
64731 
64738 
64770 
64787 
64789 
64794 
64816 
64848 
64850 
64923 
64931 
64989 
65017 
65024 
65031 
65048 
65057 
65061 
65076 
65091 
65126 
65138 


65214 


65218 
65238 
65287 
65306 
65347 
65352 


Restore default vectors 
Terminate cassette input/output 
Stop tape motor 

Check read/write pointers 

Bump read/write pointers 
Powerup reset routine 

Check for autostart cartridge 
Set kernal 


‘Restore RAM vectors 


Set RAM vector table 

Table:RAM vector/Default I/0 rout 
Perform RAM test 

Initialize system constants 

Table of IRQ vectors 

Initialize input/output registers 
Enable timer 

Set data name parameters 

Save file details 

Get status word 

Set message control flag 

Set time out flag for IEEE bus 
Read/set top of memory 

Read/set bottom of memory 
Non-maskable interrupt entry 
Reset/STOP warm start 

Handler for RS-232 NMI 

Restore and exit 

RS-232 timing table 

RS-232 receive next bit NMI 
RS-232 send 

Load timer/baud rate lookup table 
Fake IRQ 

Main IRQ entry point 

Initialize screen editor/VIC chip 
End of routine to set timer for 
sixtieth of a second IRQ 


Kernal version identifier byte 
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<-- C-64 MODE RED --> 


C-—64 KERNAL ROUTINES 


The Kernal ROM, is a table of pre-defined subroutines 
for C-64 mode. These addresses act as pointers to all 
the components needed to complete each routine. Comm- 
odore used this same set in the Vic-20. This enables 
programs using kernal ROM subroutines, to be convert- 
ed from one machine to the other. Some of the memory 
chips in the C-64 have been up-graded or changed from 
time to time. The table has remained the same. 


HEX DECIMAL LABEL ACTION 
ER IE ESE ES IS I TE 

SFF81 65409 CINT Initialize screen editor 

$FF84 65412 IOINIT Initialize input/output 

$FF87 65415 RAMTAS Initialize RAM/tape buffer, 
set screen 

SFF8A 65418 RESTOR Restore default input/output 
vectors 

SFF8D 65421 VECTOR Read/set vectored input/output 

$FF90 65424 SETMSG Control KERNAL messages 

$FF93 65427 SECOND Send a secondary address after 
a listen 

SFF96 65430 TKSA Send a secondary address after 
a talk 

SFF99 65433 MEMTOP Read and set top of memory 

SFF9C 65436 MEMBOT Read and set bottom of memory 

SFF9F 65439 SCNKEY Scan the keyboard 

SFFA2 65442 SETTMO Set time out on the serial bus 

SFFA5 65445 ACPTR Input a byte from the serial 
port 

SFFA8 65448 CIOUT Output a byte to the serial 
port 

$FFAB 65451 UNTLK # Command the serial bus to 
untalk 

SFFAE 65454 UNLSN Command the serial bus to 
unlisten 

SFFB1 65457 LISTEN Command the serial bus to 
listen 

SFFB4 65460 TALK Command the serial bus to talk 

SFFB7 65463 READST Read the status of input/output 
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HEX DECIMAL LABEL 





SFFBA 


SFFBD 
$FFCO 
SFFC3 
SFFC6 
SFFC9 
$FFCC 
SFFCF 
SFFD2 
$FFD5 
SFFD8 
$FFDB 
SFFDE 
$FFE1 
SFFE4 
SFFE7 
SFFEA 
$FFED 


SFFFO 
SFFF3 


65466 


65469 
65472 
65475 
65478 
65481 
65484 
65487 
65490 
65493 
65496 
65499 
65502 
65505 
65508 
65511 
65514 
65517 


65520 


65523 


SETLFS 


SETNAM 
OPEN 
CLOSE 
CHKIN 
CHKOUT 
CLRCHN 
CHRIN 
CHROUT 
LOAD 
SAVE 
SETTIM 
RDTIM 
STOP 
GETIN 
CLALL 
UDTIM 
SCREEN 


PLOT 


IOBASE 


ACTION 


Set logical, first and second 
address 

Set file name 

Open a logical file 

Close a logical file 

Open a channel for input 
Open a channel for output 
Close input/output channels 
Input a character from channel 
Output a character to channel 
Load RAM from a device 

Save RAM to a device 

Set the time clock 

Read the time clock 

Scan the STOP key 

Get a character from a device 
Close all channels and files 
Increment the time clock 
Return X,Y organization of 
the screen 


Read and set the X,Y cursor 


position 
Return the base address of 
input/output device 


6510 HARDWARE VECTORS 


S$FFFA 65530 TKSA 


SFFFC 
SFFFE 


65532 
65534 


NMI hardware vectors 

System reset 

MNI interrupt request & break 
hardware vectors 
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Cc—128 


BASIC 7.0 Dictionary 
BASIC 7.0 Abbreviations 
BASIC 7.0 Error Messages 
Control Codes 
Escape Codes 
Function Keys 
User Defined F-Keys 
Color 
Color 40 Column Mode 
Color 80 Column Mode 
Graphic Summary 
SPRite DEFinition mode 
Sound 
Disk Command Summary 
POKES and PEEKS 
M/L Monitor 
Memory Map 
Bank Configuration 
Bank 0 
Bank 1 
Bank 14 
Bank 15 
Kernal Routines 
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(-- C-128 MODE BLUE --> 


DICTIONARY of BASIC 7.0 


The following pages are a mini-dictionary of 7.0 key- 
words. On the first line of each entry is the keyword 
and an example of the proper syntax. The second line 
contains a brief definition, of the function the word 
performs. 





ABS 20 z=ABS(X) 
Returns the absolute value of a number. 


APPEND 800 APPEND#8,"first file" 
Opens the file named/points to the end of the file. 


AND if k=3 AND y=0 then 500 
Checks the truth of multiple operands. 


Asc 100 print ASC(a$) 
Returns the ASCII value of a character. 


ATN 230 print ATN(N) 
Returns the artangent of a number. 


AUTO AUTO [line #] 
Start up command for AUTO line numbering. 


BACKUP BACKUP d0 to dl 
Dual drive only, copy the files of disk to another. 


BANK BANK X (0-15) 
To choose one of 16 banks (0-15). 


BEGIN 100 if a then BEGIN:print "ok" 
Enables embeding lines of code in IF THEN statement. 


BEND 300 BEND 
Ends the BEGIN routine. 


BLOAD BLOAD "menu",b0, 94080 
Loads a binary file to a specified memory location. 


a TE LD 
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ES aA PE AEE EL ET EE EE ET EI 


BooT BOOT 
Loads and runs a machine language program from disk. 


BOx 235 BOX1,11,11,80,80 
Used to draw a BOX at a specific place on the screen 


BSAVE BSAVE "sprite 1",b0,p3584 to p4096 
Saves a binary file to a specified memory locatation 


BUMP 230 BUMP(1-2) 
Returns sprite collision information. 


CATALOG CATALOG 
Displays the directory of a disk. 


CHAR 50 CHARO, 20,20, "welcome",0 
Display characters at a specific place on the screen 


CHRS$ 200 print CHR$(48) 
Converts Commodore ASCII to character equivalent. 


CIRCLE 230 CIRCLE1,150,100,60,10 
Draws CIRCLEs, arcs, etc. at a specified position. 


CLOSE 100 CLOSE 15 
To close a logical file or device. 


CLR 10 CLR 
To clear all program variables. 


CMD 200 CMD1 
Directs the output to another device. 


COLLECT COLLECT 
Gathers disk space allocated to files left open. 


COLLISION 550 COLLISION(1-3},900 
Identifies sprite collisions, specifies action. 


a) 
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COLOR 10 COLOR([0-61],{1-16] 
COLOR source number, COLOR number 
Assigns colors to one of the 7 screen color areas. 


CONCAT CONCAT "menu2" to "menul" 
To merge two existing disk sequential files. 


CONT CONT 
Restarts a program after a STOP or END command. 


COPY COPY "oldfile" to "newfile" 
To COPY files from one disk to another. 


cos 140 print COS(N) 
Returns the cosine for the angle of X radins. 


DATA 40 DATA 48,0, 255 
Used to store information within a program. 


DEC DEC("DDO00") 
Returns the decimal value of a hex number string. 


DCLEAR 800 DCLEAR DO 
To clear all channels on the disk drive. 


DCLOSE 800 DCLOSE 
To close a disk file or all files of a disk. 


DEF FN 20 DEF FN z(3) = xty 
A user defined function for later use in a program. 


DELETE DELETE 200-500 
To erases lines of BASIC code. 


DIM 10 DIM a$(100) 
To declare the number of elements in an array. 


DIRECTORY DIRECTORY 
To view the directory of a disk. 
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DLOAD DLOAD "menu" 
To LOAD a BASIC program from disk. 


DO 300 DO until z=0 
To define and control a program loop. 


DOPEN 850 DOPEN#1,"data file" 
Opens disk file(SEQ,REL,rand. access) for read/write 


DRAW 250 DRAW[0-3],20,20 to 100,100 
A graphics command, used to draw to the screen. 


DSAVE DSAVE"menu" 
To SAVE a BASIC program to a disk. 


DVERIFY DVERIFY "menu" 
Compares a program in memory to one on a disk. 


ELSE 875 if x0 then 450:ELSE print"error" 
ELSE clause is only executed if the expression false 


END 900 END 
Ends a program run and displays the READY prompt. 


ENVELOPE 235 ENVELOPE[0-9),[0-15],[0-15], 

(0-15), (0-15), [0-4], (0-4095] 
Defines a musical instrument, sets: Envelope #, 
Attack rate, Decay rate, Sustain, Release, WaveForm, 
Pulse Width. : 


ER 450 print ER 
Holds the definition of the most recent error. 


ERRS 460 print ERR$(ER) 
Reads an error message from error in BASIC program. 


Exit 500 if x=10 then EXIT 
Used to exit a do loop. 
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EXP 100 print EXP(3) 
Returns the value 2.71 raised to X power. 


FAST 200 FAST 
Puts the computer in 2 MHz mode of operation. 


FETCH 300 FETCH30, 3000, 2,4000 
Gets data from a RAM expansion module. 


FILTER 300 FILTER200,1,0,0,14 
A musical command to program SID filters. 


FOR 100 FOR x=1 to 20 
Used with NEXT command to repeat a section of code. 


FN 100 print FN b(x) 
The value of a function created by DEF FN statement. 


FRE FRE [0-1] 
Returns the number of unused bytes in memory. 


GET 100 GET a$: if a$="" then 100 
To GET one character from the keyboard. 


GETKEY 200 GETKEY a$ 
Receives input from keyboard, waits for user input. 


GET # 100 GET#5,a$ 
To GET one character from an external device. 


GOSUB 100 GOSUB 500 
Tells the computer to branch to a subroutine. 


GO6G4 G064 
Sends the computer from 128 mode to 64 mode. 


GOTO 100 GOTO 450 
Tells the computer to GOTO a specific line number. 





TO 
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GRAPHIC. 10 GRAPHIC[0-1),1 
Places the computer in one of the six graphic modes. 


GSHAPE 455 GSHAPE a$, [0-319], (0-199), [0-4] 
Used to save or load rectangular areas of high 
resolution or multicolor screens. 


HEADER HEADER "disk #01",110 
This is the command used to format a disk for use. 


HELP HELP 
Highlights a line where an error has occured. 


HEXs HEX$( 45000) 
Converts a decimal number to hexadecimal. 


IF THEN ELSE = 35 if x=0 then500:ELSE end 
Evaluates BASIC expression checks for true or false. 


INPUT 340 INPUT n$ 
Prints a question mark and waits for user input. 


INPUT# 100 INPUT#5,a$ 
To retrieve data stored in a file. 


INSTR print INSTR("1234567", "45"), (0-255) 
Searchs for location of a string, displays the value 
of the starting position. 


INT 200 print INT(a) 
Returns the integer value of a number. 


JOY 455 if JOY((1-2])=135 then 885 
Displays position of joystick, status of firebutton. 


KEY KEY(1-8], "print" 
To define or list the function keys. 
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SEER SALE LT EB ET ETRE RT PSR TESS 


LEFTSs 200 a$=LEFTS$(x$,1,3) 
The left most character of a string. 


LEN 140 if LEN(a$)=4 then 450 
Returns the number of characters in the string. 


LET 100 LET a=20 
To assign a value to an array. 


LIst LIST 
To look at a program in memory, screen or print same 


LOAD LOAD "menu",8 
Reads the contents of file (disk/tape) into memory. 


LOCATE 230 LOCATE180,100 
For placement of a pixel on a high resolution screen 


LOG 100 x=LOG (45/7) 
Returns the natural logarithm of an argument. 


LOOP 200 LOOP 
Tells the computer to loop back to the DO command. 


MIDs 100 a$=MID$(x$,1,5) 
A sub-string of a larger string. 


MONITOR MONITOR 
To enter the machine language monitor mode. 


MOVSPR 255 MOVSPR[0-8],150,160 
To move or position a sprite on the screen. 


NEW NEW 
Clears BASIC memory and all memory. 


NEXT 300 NEXT xl 
Used with FOR to Gyaates an end of a FOR NEXT LOOP. 


a A 
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ON. .GOTO 600 ON a GOTO 500,800,700 
GOTO the line number shown after the GOTO command. 


ON. .GOSUB 600 ON a GOSUB 500,700,800 
Goto the line number shown after the GOSUB command. 


OPEN 700 OPEN 15,8,15 
OPENs a channel for input or output to a device. 


PAINT 200 PAINT(0-3), 20,20, [0-1] 
A graphics command to fill an area with color. 


PEEK 300 if PEEK(4000)=162 then 400 
Returns the value of a memory location. 


PEN 765 if PEN((0-4])=x then 900 
To obtain the coordinates of a light pen. 


PI 1100 print PI 
Returns the value of PI (3.14159265). 


PLAY 10 PLAYV(1-3],0[0-6),T(0-9], 
U(0-15],x(0-1],(a,etc] 
Musical command, allows selection of voice, octave, 
envelope, volume, and notes. 


POKE 100 POKE 53280,1 
To change the contents of a memory location. 


POS 230 print POS(0) 
Returns the current cursor position. 


POT 100 print POT([1-4]) 
Tells direction of game paddle/if firebutton pressed 


PRINT 100 PRINT "hello" 
To output data to the screen. 
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PRINT+# 150 PRINT#4, "hello" 
To output data to a file or device. 


PRINT USING 150 PRINT USING "####";a$ 
Defines format of material for screen/printer/device 


PUDEF 160 PUDEF "***x" 
To redefine blanks, ','s, '.'s, '$'s in PRINT USING. 


RCLR 555 print RCLR([0-6]) 
Returns the color of the color source. 


RDOT 775 print RDOT([0-2]) 
Locates a pixel on a high resolution screen/colors. 


READ 100 READ a$ 
To fill variables from a DATA statement. 


RECORD 100 RECORD#3,100,1 
To read or write data to a relative file. 


REM 10 REM date: 02/04/86 
To be used for user remarks or re-minders. 


RENAME ~ RENAME "old filename" to "newfilename" 
Command used to change the name of a file on disk. 


RENUMBER RENUMBER 10,10,1 
A command to renumber the lines of a BASIC program. 


RESTORE 300 RESTORE 
To reset the pointers to next data. 


RESUME 100 RESUME {line#/next] 
Where computer should resume after an error trapped. 


RETURN 800 RETURN 
fo exit a subroutine called by a GOSUB 
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RGR 235 print RGR({0-5]) 
Informs computer which graphic mode currently in use 


RIGHTS 450 print RIGHT$("hometown",5) 
The right most character of a string. 


RND 335 print RND(1) 
Generates a random number sequence. 


RSPCOLOR 445 print RSPCOLOR([(1-2]) 
Identifies the color values of a multicolor sprite. 


RSPPOS 555 print RSPPOS(0-15],(0-1],2 
Identifies the speed and position of a sprite. 


RSPRITE 775 print RSPRITE([0-15),(0-5] 
Identifies the six characteristics of a sprite as 
defined in the SPRITE command. 


RUN RUN 
To start the program currently in memory. 


RWINDOW 885 print RWINDOW([(0-2]) 
Defines the size of a screen window. 


SAVE SAVE "menu", [1-8] 
To store a file to disk or tape. 


SCALE 235 SCALE(0-1),{mult x=0-159],{y=0-199] 

{bit x=0-319],[y=0-199] 
To change the scale of bit-mapped images in multi- 
color/high resolution modes. 


SCNCL.R 350 SCNCLR(0-5]) 
Clears the screen when in graphics modes. 


SCRATCH SCRATCH "menu",8 
Erases a file from a disk and disk directory. 
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SGN . 300 print SGN(x) 
Returns the sign (pos., neg., or zero) of X. 


SIN 400 print SIN(x) 
Returns sine of (numeric) argument in radians. 


SLEEP 250 SLEEP(0-65535] 
Delays program execution for specified seconds. 


SLOW 450 SLOW 
Returns computer to 1 MHz speed from 2 MHZ (FAST). 


SOUND 670 SOUND[1-3],(0-65535], 
[0-32767], [0-2], [0-65535], [(0-327671, [0-3], [0-4095) 
The command to create sound and music. 


SPCC 100 print SPC(0)"hello" 
To skip X spaces forward on the same line. 


SPRCOLOR 110 SPRCOLOR(1-16), [1-16] 
Sets multicolor 1 and or 2 for sprites. 


SPRDEF SPRDEF 
To enter the sprite editor in C-128 mode. 


SPRITE 100 SPRITE(1-8],[0-1], 
{1-16], (0-1), [0-1],(0-1],(0-1] 
Turns sprites controls off or on. 


SPRSAV 235 SPRSAV1,a$ 
Saves sprite data from a text string variable to a 
storage area in memory. 


SOR 350 SQR(d) 
. Returns the square root of a positive number. 


SSHAPE 555 SSHAPEGS, 20,20 
Used to save or load rectangular areas of high 
resolution/ multicolor screens 
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STASH 650 STASH[1-65536], 
[0-65535], [0-3], [0-65535] 
Moves contents of memory into expansion RAM. 


STatus 900 print ST 
Shows the STATUS of last input/output performed. 


STEP 450 for x=] to 250 STEP 2 
Defines the value of increment for a loop. 


STOP | 545 STOP 
To end the execution of a program. 


STRs . 555 x$=STR$(x) 
Converts a number to a string. 


SWAP 650 SWAP[1-65536], 
(0-655351], [0-3], (0-65535) 

Trades contents of internal RAM with contents of 
external RAM expander. 


sys 675 SYS40965,{x],ly],[s] 
To execute machine language program or subroutine. 


TABC 20 print TAB(20) "welcome" 
To move X number of spaces forward on the same line. 


TAN 300 print TAN(x) 
Returns the tangent value of (numeric) expression. 


TEMPO 875 TEMPO[0-255] 
The musical command to define speed of play. 


TIL 900 print TI 
Current numeric value of the clock in 1/60 seconds. 


Tis 990 print TI$ 
Reads TI as a 24 hour clock. 
RE SP SSI SI NE A PS I RE ASSET LT HE 
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TO 555 for x=1 TO 500:next 
Used as part of the FOR statement. 


TRAP 200 TRAP[line#] 
For error detection within a running BASIC program. 


TROFF 500 TROFF 
Turns the trace mode off. 


TRON 800 TRON 
Turns on Trace mode for debugging BASIC programs. 


UNTIL 500 do UNTIL x=30 
Program continues until the condition is true. 


USR 555 x=USR(z+ 
To transfer to a machine language program. 


VAL 655 n=VAL(n$) 
To convert a string to a numeric value. 


VERIFY VERIFY "menu",8 
To compare a saved file against one in memory. 


VOL 20 VOL{0-15] 
A musical command to define level of sound. 


WAIT 995 WAIT1,35,35 
To pause until data matches. 


WHILE 500 do WHILE x<200:loop 
DO LOOP continues as long as the condition is TRUE. 


WIDTH 650 WIDTH[1-2) 
Determines width of pixel cursor for drawing lines. 


WINDOW 20 WINDOW[0-39], [0-24), (0-391, [0-24] 
Used to set up a screen window in 40/80 column mode. 


xXxOR 650 print XOR(x1,x1) 
Provides exclusive OR of argument values xl and x2. 
en mee 
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BASIC 7.0 ABBREVIATIONS 


Most BASIC commands, statements, and functions can be 
abbreviated to a shorter form. Listed in column one, 
are the keywords. Columns two and three are the equi- 
valent in hexadecimal and decimal. Column four is the 
abbreviated version. 


To enter an abbreviation: type the letter or letters 
shown before the word shift. Next hold down the shift 
key and type the remaining letters. 


KEYWORD HEX DECIMAL SHORT-HAND 
ABS $B6 00182 A shift B 
APPEND SFE $0E 00254 00014 A shift P 
ASC $C6 00198 A shift § 
ATN scl 00193 A shift T 
AUTO $DC 00220 A shift U 
BACKUP $F6 00246 BA shift C 
BANK SFE $02 00254 00002 B shift A 
BEGIN SFE $18 00254 00024 B shift E 
BEND SFE $19 00254 00025 BE shift N 
BLOAD SFE $11 00254 00017 B shift L 
BOOT SFE $1B 00254 00027 B shift 0 
BOX SE1 00225 N/A 

BSAVE SFE $10 00254 00016 B shift § 
BUMP SCE $03 00206 00003 B shift U 
CATALOG SFE $0C 00254 00012 C shift A 
CHAR $E0 00224 CH shift A 
CHR$ $07 00199 C shift H 
CIRCLE $E2 00226 C shift I 
CLOSE SA0 00160 CL shift 0 
CLR $9 =: 00156 C shift L 
CMD $9D 00157 C shift M 
COLLECT $F3 00243 COLL shift E 
COLLISION SFE $17 00254 00023 COL shift L 
COLOR $E7 00231 COL shift 0 
CONCAT SFE $13 00254 00019 C shift 0 
CONT S9A 00154 N/A 

COPY SF4 00244 CO shift P 
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KEYWORD HEX DECIMAL SHORT-HAND 
enn 
cos $BE 00190 N/A 
DATA $83 00131 D shift A 
DEC $D1 00209 N/A 
DCLEAR SFE $15 00254 00021 DCL shift E 
DCLOSE SFE $OF 00254 00015 D shift C 
DEF FN $96 $A5 00150 00165 N/A 
DELETE SF7 00247 DE shift L 
DIM $86 00134 D shift I 
DIRECTORY SEE 00238 DI shift R 
DLOAD SFO 00240 D shift L 
DO. SEB 00235 N/A 
DOPEN SFE $0D 00254 00013 D shift 0 
DRAW $E5 00229 D shift R 
DSAVE SEF 00239 D shift S 
DVERIFY SFE $14 00254 00020 D shift V 
ELSE $D5 00213 N/A 
END $80 00128 N/A 
ENVELOPE SFE $0A 00254 00010 E shift N 
ER $45 $52 00069 00082 N/A 
ERR$ $D3 00211 E shift R 
EXIT SED 00237 EX shift I 
EXP $BD 00189 E shift X 
FAST SFE $25 00254 00037 N/A 
FETCH SFE $21 00254 00033 F shift E 
FILTER SFE $03 00254 00003 F shift I 
FOR $81 00129 F shift 0 
FRE $B8 00184 F shift R 
FNXX $A5 00165 N/A. 
GET $Al 00161 G shift E 
GETKEY $Al SF9 00161 00241 GETK shift E 
GET # $Al $23 00161 00035 N/A 
GOSUB $8D 00141 GO shift S 
GO64 © SCB $64 00203 N/A” 
GOTO $89 00137 G shift 0 
GRAPHIC SDE 00222 G shift R 
GSHAPE $E3 00227 G shift S 
HEADER SF1 00241 HE shift A 
HELP SEA 00234 N/A 
HEX$ $D2 00210 H shift E 
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KEYWORD HEX DECIMAL SHORT-HAND 
IF THEN ELSE $8B $A7 $D5 00139 00167 00213 N/A 
INPUT $85 00133 N/A 
INPUT# $84 00132 I shift N 
INSTR $D4 00212 IN shift S 
INT $B5 00181 N/A 
JOY SCF 00207 J shift 0 
KEY $F9 00248 K shift E 
LEFT$ $c8 00200 LE shift F 
LEN $C3 00195 N/A 
LET $88 00136 L shift E 
LIST $9B 00155 L shift I 
LOAD $93 00147 L shift 0 
LOCATE $E6 00230 LO shift C 
LOG $BC 00188 N/A 
LOOP SEC 00236 LO shift 0 
MID$ $CA 00202 M shift I 
MONITOR SFA 00250 MO shift N 
MOVSPR SFE $06 00254 00006 M shift 0 
NEW $A2 00162 N/A 
NEXT $82 00130 N shift E 
ON. .GOSUB $91 $8D 00145 00141 ON GO shift S 
ON. .GOTO $91 $89 00145 00137 ON G shift 0 
OPEN SOF 00159 O shift P 
PAINT SDF 00223 P shift A 
PEEK $C2 00194 PE shift E 
PEN SCE $04 00206 00004 P shift E 
PI $50 $49 00080 00073 N/A 
PLAY SFE $04 00254 00004 P shift L 
POKE $97 00151 PO shift K 
POS $B9 00185 N/A 
POT SCE $02 00206 00002 P shift 0 
PRINT $99 00153 ? 
PRINT# $98 00152 P shift R 
PRINT USING $99 $FB 00152 00251 2US_ shift I 
_ PUDEF $DD 00221 P shift U 
RCLR $CD 00205 R shift C 
RDOT $D0 00208 R shift D 
READ $87 00135 RE shift A 
RECORD SFE $12 00254 00018 R shift E 


agi 





KEYWORD 


REM 
RENAME 
RENUMBER 
RESTORE 
RESUME 
RETURN 
RGR 
RIGHTS 
RND 
RSPCOLOR 
RSPPOS 
RSPRITE 
RWINDOW 
SAVE 
SCALE 
SCNCLR 
SCRATCH 
SGN 

SIN 
SLEEP 
SLOW 
SOUND 
SPC( 


SPRCOLOR 


SPRDEF 
SPRITE 
SPRSAV 
SQR 
SSHAPE 
STASH 
STatus 
STEP. 
STOP 
STRS 
SWAP 
sys 
TAB( 
TAN 
TEMPO 
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HEX 


$8F 
$F5 
$F8 
$8C 
$D6 
$8E 
$CC 
$c9 
$BB 
$CE 
SCE 
SCE 
SCE 
$94 
SE9 
SE8 
$F2 
$B4 
$BF 
$FE 
SFE 
SDA 
SA6 
SFE 
SFE 
SFE 


SFE 


SBA 
SE4 
$FE 
$53 
$A9 
$90 


$C4 


SFE 
$9E 
$A3 
$Co 


$07 
$05 
$07 
$09 


$0B 
$26 


$08 
$1D 
$07 
$16 


$iF 
$54 


$23 


DECIMAL 


00143 
00245 
00248 
00140 
00214 
00142 
00204 
00201 
0187 

00206 
00206 
00206 
00206 
00148 
00233 
00232 
00242 
00180 
00191 
00254 
00254 
00216 
00166 
00254 
00254 


00254 


00254 
00186 
00228 
00254 
00083 
00168 
00144 
00196 
00254 
00158 
00163 
00192 


00007 
00005 
00006 


00009 


00011 


00038 


00008 


00029 © 


00007 
00022 


00031 


00084 


00035 — 


$FE $05. 00254 00005 - 
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SHORT-HAND 


RE 
REN 
RE 
RES 
RE 


T 


N/A 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 
shift 

N/A 
shift 

N/A 


shift. 
shift 


shift 


shift 


shift 
shift 
shift 
N/A 
shift 
shift 


shift 


shift 
N/A 
shift 


N/A © 
shift - 


aes, | 


I 
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KEYWORD HEX DECIMAL SHORT-HAND 
POSES PPL PEPE SEN SD a EI EIT SD TS LATE 
TI $54 $49 00084 00073 N/A 
TI$ $54 $49 $24 00084 00073 00036 N/A 

TO $A4 00164 N/A 
TRAP $D7 00215 T shift R 
TROFF $D9 00217 TRO shift F 
TRON $D8 00216 TR shift 0 
UNTIL $FC 00252 U shift N 
USR $B7 00183 U shift S 
VAL $C5 00197 N/A 
VERIFY $95 00149 V shift E 
VOL $DB 00219 V shift 0 
WAIT $92 00146 W shift A 
WHILE SFD 00253 W shift H 
WIDTH SFE $1C 00254 00028 WI shift D 
WINDOW SFE $1A 00254 W shift I 
XOR SCE $08 00206 00008 X shift 0 


al 
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BASIC 7.0 ERROR MESSAGES 


An error message is the computer's way of telling you 
something is wrong. When exploring for the cause, you 
must. remember that a computer is very exacting in its 
demands. One forgotten comma, will generate a syntax 
error. 


The C-128 has an added feature, to help the user find 
an error, the HELP key. The HELP key is located with- 
in the gray row of keys, at the top of the keyboard. 
When the HELP key is pressed, the line containing the 
error is shown on the screen. The code will be high- 
lighted, from the start of the problem, to the end of 
the line.: Next review the high-lighted portion of the 
code very carefully. The clues to an error, are often 
subtle. Stop, think, take time to review the problem 
completely. The answer is usually in plain sight. ‘The 
computer can only follow your instructions. 








# MESSAGE DESCRIPTION 
1.TO0O MANY FILES Limit 10 files open at once 
2.FILE OPEN Tried to open an open file 
3.FILE NOT OPEN Must open file before use 
4. FILE NOT FOUND File name not found on disk 
5.DEVICE NOT PRESENT 1/0 device can not detected 
6.NOT INPUT FILE Attempted to GET or input 


data from an output file 
7.NOT OUTPUT FILE Attempted to send data to an 
input only file 
8.MISSING FILE NAME file name not in the command 
9. ILLEGAL DEVICE # Tried to use wrong device 
(Save to the screen, etc.) 
10.NEXT WITHOUT FOR Executed NEXT without for 


11. SYNTAX Wrong punctuation, spelling, 
line number missing, etc 

12.RETURN WITHOUT A RETURN without a GOSUB has 
been detected 

13.0UT OF DATA READ statement found, when 


there is no data left to read 
14. ILLEGAL QUANITY Number used outside of range 


ST RRS SE SSE NES SDT TEER EPS 
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# MESSAGE 


15. OVERFLOW 

16.0UT OF MEMORY 
17.UNDEF'D STATEMENT 
18.BAD SUBSCRIPT 


19.REDIM'D ARRAY 
20.DIVISION BY ZERO 
21. ILLEGAL DIRECT 


22. TYPE MISMATCH 
23.STRING TO LONG 
24.FILE DATA 


25.FORMULA TOO COMPLEX 


26.CAN'T CONTINUE 
27.UNDEF'D FUNCTION 
28. VERIFY 


29. LOAD 

30. BREAK 

31.CAN'T RESUME 
32.LOOP NOT FOUND 
33.LOOP WITHOUT DO 
34.DIRECT MODE ONLY 
35.NO GRAPHICS AREA 
36.BAD DISK 

37.BEND NOT FOUND 


38.LINE # TOO LARGE 


39. UNRESOLVED 


40. UNIMPLEMENTED 
41.FILE READ 





DESCRIPTION 


SS a TL I SEE LT BS a IE a EE 


Result larger than allowed 
Out of K, all memory used 
Line number does not exist 
Array number outside range 
defined in DIM statement 
Array may only be DIMed once 
Division by zero not allowed 
INPUT,GET, INPUT#, get# are 
only allowed within program 
Wrong data type 

String limit 255 characters 
Bad data from tape or disk 
received by the computer 
Operation too complex for 
the computer to understand 
Program has an error or has 
been edited 

Function hasn't been defined 
defined by the user 

File in memory does not 
match one on the device 
Loading problem 

Stop key has been pressed 
RESUME without TRAP found 
PRG found DO without LOOP 
LOOP found without DO 

Use in direct mode only 
Graphics area undefined 
Failed to format, may be bad 
"IF...THEN BEGIN" or “IF.. 
THEN...ELSE BEGIN" found 
without BEND to match BEGIN 


_Line number is larger than 


the allowable 63999 

Line number referred to is 
missing 

Command not in BASIC 7.0 . 

An error has been found while 
loading/reading from a device 


RAS FAT AE ER PB TE TE ND TE POET TEE 
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128 CONTROL CODES 


The CONTROL KEY is found at the middle left-hand side 
of the keyboard. The key generates control functions. 
These are often special tasks, or short cuts, to much 
larger jobs. To perform a control function, hold down 
the CTRL key, and press the other key that is called 
for at the same time. The CHR$ functions are an ano- 
ther way of doing these same tasks within BASIC code. 
The CHR$ refers to a table, of character string codes 
in the computers memory. The CHR$ function converts a 
Commodore ASCII code to its character equivalent. 


C= . Commodore logo key, location, lower left corner 
of the keyboard. 


STL SS ET TI EEL BT a a 


CHR$ CTRL KEY FUNCTION 

NRT ML NALS OLD SMES LEGIT EE ETP NIL ONTE SE IP LEE IEE ALE TEA EES TEE EINES AEE! PLLA LE GE PLLC DA DNAS EEDA DOLE 

CHR$(2) CTRL B Underline (80 column) 

CHRS$(5) CTRL2/E Character color white 
(40 or 80 column mode) 

CHR$(7) CTRL G Produce bell tone 

CHRS$(9) CTRL I Send cursor to next set 
tab position 

CHR$(10) CTRL J Send a line feed 

CHR$(11) CTRL K Character set change on 

CHR$(12) CTRL L Character set change off 


CHR$(13) CTRL M Send carriage return/line 
feed to computer, enter a 
line of BASIC code 


CHR$(14) CTRL N Character set to upper & 
lowercase 
CHR$(15) CTRL O Turn flash on (80 column) 
CHR$(17) | CRSR DN/CTRL Q Cursor down one row 
CHR$(18) CTRL 9 Reverse field on 
CHR$(19) HOME/CTRL S Cursor to home position 
CHR$( 20) DEL/CTRL T Delete character and 
fill space 
CHR$(24) CTRL X Tab set to clear 
CHR$(27) ESC/CTRL [ Send ESC character 
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i a 


CHR$ CTRL KEY FUNCTION 


TS TT a a Ee a TE ES aS TI ET TITTY 














CHR$(28) CTRL3/CTRL/ Character color to red 
(40 or 80 column) 
CHR$(29)  CRSR/CTRL] Cursor one column right 
CHR$(30) CTRL6/CTRL Character color to green 
(40 or 80 column) 
CHR$(31) CTRL 7 Character color to blue 
CHR$(34) =" Prints a quote mark 
CHR$(129) C=1 Character color to orange 
(40 column), dark purple 
(80 column mode) 
CHR$(130) Underline off (80 column) 
CHR$(131) Run PRG, keyboard only 
CHR$(133) Fl Reserved CHR$ for Fl key 
CHR$(134) F3 Reserved CHR$ for F3 key 
CHR$(135) FS Reserved CHR$ for F5 key 
CHR$(136) F7 Reserved CHR$ for F7 key 
CHR$(137) F2 Reserved CHR$ for F2 key 
CHR$(138) F4 Reserved CHR$ for F4 key 
CHR$(139) F6 Reserved CHR$ for F6 key 
CHR$(140) F8 Reserved CHR$ for F8 key 
CHR$(141) SHIFT/RETURN Carriage return/line feed 
without BASIC code 
CHR$(142) Character set upper 
case, graphics 
CHR$(143) Flash off (80 column) 
CHR$(144) CTRL 1 Character color black 
(40 or 80 column mode) 
CHR$(145) CRSR UP Move cursor up one row 
CHR$(146) CTRL 0 Reverse field off 
CHR$(147) HOME Clear window screen 
and cursor home 
CHR$(148) INST Insert command 
CHR$(149 = C=2 Character color to brown 
(40 column mode). 
Dark yellow (80 column) 
CHR$(150) C=3 Character color to light 


red (40 or 80 column) 


NS SP I PE TE I I TE I ST A OE TT I 


ey ae 
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LS EE I LE EL EE NS NEE PEE ZEEE I EE ES IED 


CHR$ CTRL KEY FUNCTION 
a a SD 
CHR$(151) C=4 Character color dark 


gray (40 column mode), 
dark cyan (80 column) 


CHR$(152) C=5 Character color medium 
gray (40 or 80 column) 
CHR$(153) C=6 Character color to light 
green (40 or 80 column) 
CHR$(154) C=7 Character color light 
blue (40 or 80 column) 
CHR$(155) C=8 Character color light 
gray (40 or 80 column) 
CHR$(156) CTRL 5 Character color purple 
(40 or 80 column mode) 
CHR$(157) CRSR LEFT Cursor left one column 
CHR$(158) Character color to yellow 
CHR$(159) CTRL 4 Character color cyan 


(40 column mode) 
Light cyan (80 column) 
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ESCAPE CODES 


The ESCAPE key is used to activate special functions, 
such as editing, scrolling, define windows, etc.. The 
ESCAPE key is gray and located in the upper left cor- 
ner of the keyboard. 


To activate one of the commands, first press and then 
RELEASE the ESCAPE key followed by the desired letter 
key. You MUST remember, to release the ESCAPE key be- 
fore pressing the next character. 


al 


ESCAPE KEY ESCAPE FUNCTION 
ne A at a fT TT I PT ET EA oe ED 
ESC Q Erase to the end of the current line 
ESC P Erase to the start of the current line 
ESC D Delete the current line 
ESC I Insert a line 
ESC A Auto-insert mode on 
ESC 0 Auto-insert mode off, 80 column only 
ESC C Quote and insert mode off 
ESC @ Clear everything to the end of screen 
ESC J Move cursor to start of current line 
ESC K Move to the end of the current line 
ESC Y Set default tab stops (8 spaces) 
ESC Z Clear all tab stops 
ESC L Scrolling on 
ESC M Scrolling off 
ESC V Scroll up 
ESC W Scroll down 
ESC G Bell on (by control-G) 
ESC H BELL OFF 
ESC E Cursor to non-flashing mode 
ESC F Cursor to flashing mode 
ESC B Bottom of window at cursor position 
ESC T Top of window at cursor position 
ESC X Swap output device (40/80 col.) 
ESC U Underlined the cursor (80 column only) 
ESC S Change to block cursor (80 col. only) 
ESC R Reverse video on (80 column only) 

N 


Reverse video off (80 column only) 
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C-—-128 FUNCTION KEYS 


The four function keys are located in the upper right 
hand corner of the keyboard. To use the keys, press 
number one, three, five, or seven for the first four. 
Numbers two, four, six, or eight are activated by dep 
ressing SHIFT at the same time as the key. All eight 
of the keys have been pre-defined in the C-128 mode, 
by the manufacture as follows: 


(tees - Se, ee | Wee. . Ae, - ee 


KEY CHR$ FUNCTION ACTION 





Fl (133) | GRAPHIC To enter the GRAPHIC mode 

F2 (137) DLOAD Prints DLOAD, you add the 
file name to load program 

F3 (134) DIRECTORY Displays Directory of disk 


F4 (138) SCNCLR Clears the screen 

F5 (135) DSAVE Prints DSAVE, you add the 
file name to be saved 

F6 (139) RUN RUNs the current program 
in memory 

F7 (136) LIST LISTs the current program 


in memory to the screen 
F8 (140) MONITOR To engage the machine lang- 
uage monitor 





USER DEFINED F-—-KEYS 





The Function keys may also be programmed by the user 
from a BASIC program or in direct mode. 


EXAMPLE: KEY 8,"OPEN 15,8,15" 
In the above example, key 8 has been user-defined to 


OPEN the disk drive channel. This may be a time saver 
if used often in your program. 


bo lees: hee, dee 1S. eS ee, ee 
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C-—-123 COLOR 


The Commodore 128 offers sixteen colors, in both the 
forty or eighty column modes. The screen, border, or 
character color, may be changed to any of the sixteen 
hues. The following charts list the colors available, 
plus the three modes available to change color in 128 
mode. 


COLOR COMMAND 
To select the desired color, type the following: 


COLOR (source), (color) 
The choice of source (0-6) is as follows: 


40 column background color 

Foreground for the graphics screen 
Foreground color 1 for multicolor screen 
Foreground color 2 for multicolor screen 
40 column border (text or graphics mode) 
Character color (40 or 80 column text) 
80 column background color 


AO fFODND Ee © 


Color is a value, from column one, of the charts that 
follow (40 or 80 column). 


CONTROL or COMMODORE key 

The commands in column three ( labeled KEY ) are used 
to modify character color only. To use, hold down the 
CONTROL or COMMODORE LOGO key, plus the number of the 
color at the same time. 


EXAMPLE: Press the CONTROL key and the number seven. 
From now, until another color command is entered, all 
characters will be in yellow. 


CHRS$ 

The fourth column displays the CHR$ value for each of 
the sixteen colors. The primary use for these, are to 
alter the character color within program code. 


EXAMPLE: CHR$(28) All characters will now be red. 
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COLOR 40 COLUMN MODE 


YELLOW 
ORANGE 
BROWN 
LIGHT RED 
DARK GRAY 
MEDIUM GRAY 
LIGHT GREEN 
LIGHT BLUE 
LIGHT GRAY 


LIGHT CYAN 


LIGHT PURPLE 


DARK GREEN 
DARK BLUE 


LIGHT YELLOW 


DARK PURPLE 
DARK YELLOW 
LIGHT RED 
DARK CYAN 
7MEDIUM GRAY 
LIGHT GREEN 
LIGHT BLUE 
LIGHT GRAY 


On HU S & dH 


1 
2 
3 
4 
5 
6 
7 
8 


CHR$(144) 
CHR$(5) 
CHR$(28) 
CHR$(159) 
CHR$(156) 
CHR$(30) 
CHR$(31) 
CHR$(158) 
CHR$(129) 
CHR$(149) 
CHR$(150) 
CHR$(151) 
CHR$(152) 
CHR$(153) 
CHR$(154) 
CHR$(155) 


CHR$(144) 
CHR$(5) 

CHR$( 28) 
CHR$(159) 
CHR$(156) 
CHR$(30) 
CHR$(31) 
CHR$(158) 
CHR$(129) 
CHR$(149) 
CHR$(150) 
CHR$(151) 
CHR$(152) 
CHR$(153) 
CHR$(154) 


CHR$(155) 





fas (ee en HS: Ee HES ee le - Wee be ee Ce, ee ee, 7 
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GRAPHIC COMMAND SUMMARY 


The Commodore 128 has several types of unique graphic 
features. A creative programmer can become an accomp- 
lished artist in a short period of time 


Text may be displayed in a rainbow of various colors. 
Elaborate graphic images can be created by connecting 
letters, numbers, special symbols, and graphic char- 
acters of the three available keyboards. 


A second type of graphic display, is the bit-map mode 
for drawing intricate pictures and designs. Included 
in this category are both standard bit-map and multi- 
color bit-map mode. In the bit-map modes, you control 
each pixel, thus allowing great detail in your work. 


The third type of screen display, is a combination of 
text and bit-map graphics. This allows a split screen 
as you might see in an adventure game, picture at the 
top of the screen and text at the bottom. 


An additional graphic feature is available, known as 
a sprite. The sprite is a movable graphic shape, that 
may be in any user defined form. The sprite image may 
be animated, colored, or even multi-colored. The size 
of a sprite, is 24 pixels wide, by 21 pixels high, in 
regular bit map mode or 12 pixels in width by 21 high 
in multicolor bit map mode. There are three (3) meth- 
ods for sprite creation in the C-128 mode: 


1. Sprite statements within a program. 

2. SPRite DEFinition mode (SPRDEF), this mode uses 
an editor within the C-128 

3. Created the same as in the C-64 mode. 


The first step in graphics programming, is selection 
of the graphic mode. The proper syntax is: 


EXAMPLE: GRAPHIC1,1 


In the example, the first number one (1), is GRAPHIC 
mode one (1), (standard bit map), the second one (1) 
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clears the csreen (0= not clear, 1= clear. 


DESCRIPTION 


40 column standard text 
Standard bit map 


Standard bit map (split screen) 
Multicolor bit map 

Multicolor bit map (split screen) 
80 column TEXT only 





The following pages, are a list of graphic commands. 
On the first line of each entry is the command and an 
example of syntax. The second line is a brief defin- 

ition of the function the command performs. 


SA i NEE PTT SE PE I A A TEE EDIE 


BOx 235 BOX1,11,11,80,80 
Used to draw a BOX at a specific place on the screen 


BUMP 230 BUMP[1-2) 
Returns sprite collision information. 


CHAR 50 CHARO, 20,20, "welcome",0 
Display characters at a specific place on the screen 


CIRCLE 230 CIRCLE1,150,100,60,10 
Draws CIRCLEs, arcs, etc. at a specified position. 


COLLISION 550 COLLISION[1-3],900 
Identifies sprite collisions, specifies action. 


COLOR 10 COLOR[0-6],[1-16] 
COLOR source number, COLOR number 
Assigns colors to one of the 7 screen color areas. 


DRAW 250 DRAW(0-3)],20,20 to 100,100 
A graphics command, used to draw to the screen. 


GRAPHIC 10 GRAPHIC{0-1),1 
Places the computer in one of the six graphic modes. 
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bee 
GSHAPE 455 GSHAPE a$,(0-319],(0-199],[0-4] 
To save or load rectangular areas of high resolution 
or multicolor screens. 


LOCATE 230 LOCATE180, 100 
For placement of a pixel on a high resolution screen 


MOVSPR 255 MOVSPR[0-8], 150,160 
The MOVSPR statement allows the exact position or 
movement of a sprite. 


PAINT 200 PAINT(0-3], 20,20, [0-1] 
A graphics command to fill an area with color. 


RCLR 555 print RCLR((0-6)) 
Returns the color of the color source. 


RDOT 775 print RDOT((0-2]) 
Locates a pixel on a high resolution screen/colors. 


RGR 235 print RGR((0-5)) 
Informs computer which graphic mode currently in use 


RSPCOLOR 445 print RSPCOLOR([1-2]) 
Identifies the color values of a multicolor sprite. 


RSPPOS 555 print RSPPOS(0-15],{0-1],2 
Identifies the speed and position of a sprite. 


RSPRITE 775 print RSPRITE(0-15],(0-5) 
Identifies the six characteristics of a sprite as 
defined in the SPRITE command. 


SCALE 235 SCALE[0-1],{mult x=0-159], [y=0-199] 

(bit x=0-319],{y=0-199) 
To change the scale of bit-mapped images in multi- 
color/high resolution modes. 


SCNCLR 350 SCNCLR[0-5] 
Clears the screen when in graphics modes. 


SPE CS A a MAP ARN PP A AE OTR AI ON PINS RE EN SE IPI SEE IT 
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SPRCOLOR 110 SPRCOLOR[1-16],[1-16] 
Sets multicolor 1 and or 2 for sprites. 


SPRDEF SPRDEF 
To enter the sprite editor in C-128 mode. 


SPRITE 100 SPRITE(1-8],{(0-1], 
[1-16], (0-1),(0-1),(0-1],(0-1] 
Turns sprites controls off or on. 


SPRSAV 235 SPRSAV 1,a$ 
Saves sprite data from a text string variable to a 
storage area in memory. 


SSHAPE 555SSHAPE d$, 20,20 
Used to save or load rectangular areas of high 
resolution/ multicolor screens 





SPRite DEFinition mode 





The following commands are used to create a sprite 
using the internal sprite editor in BASIC 7.0. To 
engage the editor type SPRDEF and press return. 


| RR Pp ca A SP IS I TE ES EES TT TE A RES CE TD 


Shift CLR key Erases the entire work area 


M key Turns on/off multicolor sprite 
CTR1 1-8 Selects sprite foregroundcolor 1-8 

= 1-8 Selects sprite foreground color 9-16 

1 key Turns off pixel color 

2 key Turns on pixels in foreground color 

3 key Turns on areas in multicolor 1 
4 key Turns on areas in multicolor 2 
A key Turns on/off automatic cursor movement 
CRSR keys Moves the cursor within the work area 
RETURN Moves cursor to start of next line 
HOME key Moves cursor/top left cornor/work area 
X key Expands sprite horizontally 
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EPL ASS SE SE 


Y key Expands sprite vertically 


Shift RETURN Saves sprite from work area/returns to 
SPRITE NUMBER prompt 

C key Copies one sprite to another 

STOP key Turns off displayed sprite/returns to 
SPRITE # prompt/no change to sprite 

RETURN key (at SPRITE # prompt) Exits SPRDEF mode 


eel 
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The C-128 mode has the same musical capability as the 
C-64. The one exception is the usage of BASIC 7.0 for 
programming the SID (Sound Interface Device) chip.The 


«-- C-128 MODE BLUE --> 


128 SOUND 


new powerful commands, make creating music very easy. 


A note may be entered as a letter, as read from sheet 


music, rather than complicated poke values. 


The following are the functions of SID: 


3 independent programmable voices 
4 mixable waveforms for each voice 
Mixable filters to choose or omit selected sounds 


Envelope 


generator (ADSR control) for each voice 


10 predefined envelopes for musical instruments 
2 cascadable ring modulators 

Alternation option for external signal sources 
2 b-bit A/D converters 


The BASIC 7.0 commands employed to program music, are 


listed below. 


SOUND 


EXAMPLE: 


SOUND( vc], (freq],(durJ,(dirJ,[(min],[sv], 
(w£),(pw] 


The commands to create sound and music. 


vc 
freq 
dur 
dir 


min 


sv = 


pw 


Select VoiCe 1,2, or 3 

Sets FREQuency level (0-65535) 

Sets DURation of sound (0-32767) 
Sets DiRection sound is incremented 
0 = up, 1 = down, 2 = up and down 
Select MINimum frequency (0-65535) 
only if DIR specified 

Step Value for the sweep (0-32767) 
Select WaveForm, 0 = triangle, 1 = sawtooth, 
2 = variable pulse, 3 = white noise 
Set Pulse Width (0-4095) 


DIR,MIN,SV,WF, and PW are optional parameters. 
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ENVELOPE 


EXAMPLE: ENVELOPE [el], {a],({d),(sl,(r),(wfl, [pw] 
Defines a musical instrument, sets the following: 
Envelope#, Attack rate, Decay rate, Sustain, Release, 
WaveForm, Pulse Width. 


e = envelope number (0-9). There are 10 predefined 
envelopes for musical instruments. This area may 
also be defined by the user. 


em em 


ENVEL- INSTRU- DE- SUS- RE- WAVE- 
OPE # MENT ATTACK CAY TAIN LEASE FORM WIDTH 
dc i 
0 Piano 0 9 0 0 2 1536 
1 Accordion 12 «#0 12 0 1 
2 Calliope 0 0 25 0 0 
3 Drum 0 5 5 0 3 
4 Flute ) 4 4 0 0 
5 Guitar 0 9 2 1 1 
6 Harpsichord 0 9 0 0 2 
7 = Organ 0 9 9 0 2 512 
8 Trumpet 8 9 4 1 2 2048 
9 Xylophone 0 9 0 0 0 


NN SE SE TED BSS FT DS TP a PI TT SRI ESS 


a = attack rate (0-15). Attack is the rate at 
which a musical note reaches its peak. 


d = decay rate (0-15). Rate at which a note 
decreases from peak volume. 


sS = sustain level (0-15). Level at which a note is 
played between attack and delay, 


r = release rate (0-15). The rate at which a note 
decreases from its sustain level to zero. 


wf = waveform (0-4). The type of sound wave. 0 = 


triangle, 1 = sawtooth, 2 = pulse (square), 3 
= noise, 4 = ring modulation. 
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pw = pulse width (0-4095). Length of time between 
notes. 


FILTER 
EXAMPLE: FILTER(cf£),[1p],({bp],(hp],(res] 


The FILTER command is used to increase the sharpness 
and quality of sound. 


c£ = Cutoff Frequency (0-2047) 
lp = LowPass filter 0 = off, 1 = on 
bp = BandPass filter 0 = off, 1 = on 
hp = High Pass filter 0 = off, 1 = on 
res = RESonance (0-15) 

PLAY 


EXAMPLE: PLAY"CDEFGAB" 
Allows selection of musical notes. Enclose the letter 


of the note or notes 


within quote marks. Many options 


my also be added between the SAME quote marks. To 


specify the duration 
following before the 


W 
I 


whole note 4H 
eighth note S 


R adds a rest, M 


For further control, 


of the note, place one of the 
note: 


half note Q = quarter note 
sixteenth note 


says wait for end of measure 


add one of the following control 


characters plus a value from the column labeled 


RANGE. 
CONTROL 


DEFAULT 


CHARACTER DESCRIPTION RANGE SETTING 


Voice 1-3 
Octave 0-6 


Envelope 0-9 


Volumn 
Filter 


0-15 
0=off,1=on 
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TEMPO 


EXAMPLE: TEMPO [x] 
The musical command to define speed of play. The x 
may be a value from the low of 0 to the high of 255 


VOL 
EXAMPLE: VOL [x] 


Defines the level of sound. The x may be a value from 
the low of 0 to the high of 15 


SED Ds = 
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BASIC 7.0 DISK COMMANDS 


The commands listed below are used with the 1571 disk 
drive in C-128 mode. 








COMMAND USE 

APPEND Append data to file 

BLOAD Load a binary file starting at 
specific memory location 

BOOT Load and execute program 

BSAVE Save a binary file to a specified 

memory location 

CATALOG Display contents of dir. on monitor 

CMD Redirect screen output to disk file 

COLLECT Free inaccessible disk space 

CONCAT Concatenate two data files 

COPY Copy files between devices 

DCLEAR Clear open channels on disk drives 

DCLOSE Close logical disk file 

DIRECTORY Display contents of dir. on monitor 

DLOAD Load a BASIC program from disk 

DOPEN Open disk file for read/write 

DSAVE Save a BASIC program to disk 

DVERIFY Compare file in mem to file on disk 

GET# Read one byte from a record 

HEADER To format a disk, make ready to use 

INITIALIZE Returns drive to power-up condition 

INPUT# Read whole record from disk 

PRINT# Output data to a file 

RECORD Position REL file pointers 

RENAME Change name of a file on disk 

RUN Execute BASIC program from disk 

SCRATCH Erase file(s) from a disk 

VERIFY Compare file in mem to one on disk 
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C-—-128 POKES and PEEKS 


The C-128 (in 128 mode) has 131,072 individual memory 
locations. Each address stores a number ranging from 
0 to 255. A PEEK allows the user, to read the number 
stored at a given address. A POKE lets you write data 
into a RAM (Random Access Memory ) location. The ROM 
(Read Only Memory) may be read, but cannot be written 
to. POKEs and PEEKs can extend your BASIC programming 
skills to a higher level. The following list is just 
a beginning, explore other locations. You won't hurt 
your computer, and you may learn a lot. 


SS EE a TS I IO AISLE 2 ET NSC 
POKE or PEEK (bank 0) ACTION 
POKE 24,35 Replaces LINE # with # character 


default = 27 
POKE 24,37 No line numbers, default = 27 


POKE 24,1 Listing is garbage, default = 27 

-POKE 24,19 Double space listing, default = 

POKE 24,53 Locks up the system, default = 2 

PEEK (215)=0 40 column mode 

PEEK (215)=128 80 column mode 

POKE 775,171 Crash if list is tried, default=81 

POKE 775,200 Line #s visible, code gone,default=81 

POKE 808,222 Disables RUN/STOP/RESTORE,default=110 

POKE 808,233 Disables RUN/STOP only, default=110 

POKE 819,243 Disables SAVE, prints ? OUT OF MEMORY 
DEFAULT = 245 

POKE 819,243 Disables LIST function 

POKE 2594,96 Disables repeat of keys, default=128 

POKE 53265,11 Screen blanking, default=27 

POKE 53280,X X = screen color value 

POKE 53281,X X = border color value 

POKE 53296,1 Fast mode = 2 MHz 

POKE 53296,252 Slow mode = 1 MHz 

POKE 53220 Joystick port 1 

POKE 56321 Joystick port 2 

SYS 65357 Go to C-64 mode 

SYS 65375 From 40 to 80 column mode or back 

IS RR I SB IT IE TE IT I A i UE I ENS AT RAIS 


27 
7 
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Cci28s M/I. MONITOR 


The C128 contains a built in machine language monitor 
that enables the user to read or write M/L. The mon- 
itor may be used in C128 mode, 40/80 column. To enter 
this mode from BASIC, type: 


Example: MONITOR <RETURN> or press 'F8'. 


NOTE: <> Required parameters [] Optional parameters 


COMMANDS 
SR SP I TT EO EI IS 
ASSEMBLE 
FUNCTION: To enter a line of assembly code. 
FORMAT : A <start add><opcode> [operand] 


COMPARE 

FUNCTION: Compares 2 sections of memory and displays 
the differences. 

FORMAT : C (start add><end add><new start add) 


DISASSEMBLE 
FUNCTION: Disassemble ML code into assem. 
FORMAT : D {start add><end add] 


FILL, 
FUNCTION: Fills a range of memory with specified byte 
FORMAT : F (start add><end add><byte> 


GO 
FUNCTION: Begin program, at specific address. 
FORMAT : G [add] 


HUNT 
FUNCTION: Look for specific byte 
occurrences of data. 
FORMAT : H <star add><end add><byte 1>[<byte 2>..] 
or 
H <start add><end add><'ASCII string'> 
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JUMP 
FUNCTION: Jumps to specified subroutine. 
FORMAT : J [add] 


LOAD 
FUNCTION: Load a file from disk or tape. 
FORMAT : L <"filename">(, <device#>{,<load add>)] 


MEMORY 
FUNCTION: Display of memory in HEX. 
FORMAT : M (<start add>(<end add>)] 


REGISTERS 
FUNCTION: Displays the registers. 
FORMAT : R 


SAVE 

FUNCTION: Saves a range of memory to disk or tape. 

FORMAT : S <"filename">, (device#>,<start add), 
«end add+1> 


TRANSFER 
FUNCTION: Move segment of mem. to new area. 
FORMAT : T <start add><end add>(new start add) 


VERIFY 
FUNCTION: Check file on device with memory. 
FORMAT : V <"filename">[(,<device#>[{,<load add>]] 


EXIT 
FUNCTION: Exits to BASIC. 
FORMAT : X 


FUNCTION: Indicates an assembler directive. 
FORMAT 


> 

FUNCTION: Modifies memory. 

FORMAT : > 

an a 
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LEE LE TE RIE I IS LE TE 


FUNCTION: Modifies 8502 register displays. 
FORMAT : ; 


@G 

FUNCTION: Displays the following: 
Disk status @(device#] 
Disk command @{device#][,<command string? ] 
Catalog @(device#),${(<drive>](:<file spec>]] 


SE EE ETE TE TT ES I 
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C—-128 MEMORY 


The following memory maps have been included, so that 
the user, may explore the architecture of C-128 mode. 
The BANKS allow memory, to be rearranged to different 
configurations. Bank 0 from $0000 to $03FF, is common 
to all of the BANK areas. Bank 0 contains work areas 
and the user's BASIC program. One might think of this 
system as a room of furniture, that may be rearranged 
to suit the user's programming need. The computer de- 
faults to BANK 15 at power-up. 


BANK CONFIGURATION 


RAM (0) only 

RAM (1) only 

RAM (2) only 

RAM (3) only 

Internal ROM, (0), I/0 

Internal ROM, (1), I/0 

Internal ROM, (2), I/0 

Internal ROM, (3), I/0 

External ROM, (0), I/0 

External ROM, (1), I/0 

External ROM, (2), I/0 

External ROM, (3), I/0 
Kernal/Internal ROM (low), RAM (0), I/0 
Kernal/External ROM (low), RAM (0), I/0 
Kernal/BASIC ROM, RAM (0),Character ROM 
Kernal/BASIC ROM, RAM (0), I/0 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 











BANK (0) 0000-03FF COMMON TO ALL BANKS 

HEX DECIMAL DESCRIPTION 

0000 0 6510 data direction, processor 
port 

0001 1 6510 data register, processor 
port 

0002 2 Storage for bank byte 

0003 3 Storage/program counter, high 

0004 4 Storage/program counter, low 
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I AN ED EE EE EE TI EOP TE SE EE OTT, 


DESCRIPTION 


OP EE ET EAE TT EE I ESE ETM ITTY 


HEX DECIMAL 
0005 5 
0006 6 
0007 7 
0008 8 
0009 9 
000A 10 
000B 11 
000C 12 
000D 13 
000E 14 
000Fr 15 
0010 16 
0011 17 
0012 18 
0013 19 
0014 20 
0015 21 
0016-0017 22-23 
0018 24 
0019-0020 25-26 
001B-001D 27-29 
001E-0020 30-32 
0021-0023 33-35 
0024-0025 36-37 
0026-0027 38-39 
0028 40 
002D-002E 45-46 
002F-0030 47-48 
0031-0032 49-50 
0033-0034 51-52 
0035-0036 53-54 
0037 55 
0039-003A 57-58 
003B-003C 59-60 
003D-003E 61-62 


Storage for CPU status register 
Storage for accumulator 

Storage for X-register 

Storage for Y-register 

Storage for stack pointer 

Look for quote at end of string 
Screen color/last tab 

Disk flag: O=load, l=verify 
Pointer: #/subscripts/input buf. 
Flag: default dim 

Type: FF=string; 00=numeric 
Type: 80=integer; 00=floating 
point 

Flag: LIST,read DATA,garb. coll. 
Flag: subscript reference 

Flag: $00=input, $40=get, 
$98=read 

Flag: tan sign/compare results 
Current I/O prompt flag 

Integer value 

Pointer: temporary string stack 
Last temporary string address 

3 byte stack/temporary strings 
3 byte stack/temporary strings 
3 byte stack/temporary strings 
Utility pointer area 

2 byte help pointer index 2 
Floating point, product/multi. 
Pointer: start of BASIC (bank 0) 
Pointer: start of variables 
(bank 1) 

Pointer: start of arrays 
Pointer: end of arrays 

Pointer: string storage (moving 
down) 


‘Lowest string vector 


Pointer: limit of memory(bank 1) 
Current BASIC line number 
Text pointer: BASIC work point 


ET RES AN  SED NT I EE PEI A EE TE EE EE EE LE EY 
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HEX 


DECIMAL 


DESCRIPTION 


LD 


003F-0040 
0041-0042 
0043-0044 
0045-0046 
0047-0048 
0049-004A 
004B-004C 
004D-004E 
004F 


0050-0051 
0052-0054 


0055 
0056-0057 
0059 


005A-005B 
005C-005D 
005E 

005F-0060 


006B-006E 
006F 
0070 
0071 
0072-0073 
0074-0075 


007A-007C 


63-64 
65-66 


Pointer: PRINT USING, char.search 
Current DATA line number 
Current DATA address 

Pointer: INPUT routine hi/low 
Current variable name 

Current variable name 

Pointer: mask/AND,LIST,FOR NEXT 
Temp. storage for prog. pointer 
Mask for compare operation ):2, 
=:34,¢:8 

Pointer: FN and garbage collect. 
Pointer: variable list-string 
compare 

Help flag: $xx=HELP, $xx=LIST 
Jump vector/function evaluation 
Area for INSTRING operation or 
Temporary pointer 1 

Pointer: block transfer,DIM init 
Pointer: block transfer 
Temporary pointer 2 

Number of places before/after 
Decimal for conversion 

Exponent sign of # read 
Accum.#1: exponent 

Accum. #1: mantissa 

Accum.#1: sign 

Pointer: Polynomal evaluation 
Accum.#2: exponent 

Accum. #2: mantissa 

Accum.#2: sign 

Sign comparison, accum. #1/#2 
Accum.#1 low order (rounding) 
Pointer: cassette buffer 

AUTO command offset value, O0=off 
Flag:1=BASIC-st. set 10K higher 
Sprite # counter/leading zeros 
Help counter 

Temp. storage/indirect loading 
Description/error variable DS$ 
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HEX DECIMAL DESCRIPTION 

007D-007E 125-126 End of stack during program run 
007F 127 $xx=RUN mode, $xx=direct mode 
0080 128 Pointer:statue of DOS parser 
0083 131 Current color for graphic mode 
0084 132 Multi-color mode: color 1 

0085 133 Multi-color mode: color 2 

0086 134 Foreground color 


0087-0188 135-136 X-direction scale factor 
0089-008A 137-138 Y-direction scale factor 


008B 139 Stop draw,if not background col. 

008C-008D 140-141 Pointer:address/graphic routines 

O08E 142 Temp storage 1/graphic routines 

0o8sF 143 Temp storage 2/graphic routines 

0090 144 Status word ST 

0091 145 Keyswitch IA:STOP and RVS flags 

0092 146 Time constants/cassette 

0093 147 Load flag: 0=LOAD,1=VERIFY 

0094 148 Serial bus flag: char in buffer 

0095 149 Character in buffer/serial bus 

0096 150 End-of-tape received from tape 

0097 151 Temporary data address 

0098 152 Number of files open 

0099 153 Input device, normally 0 

009A 154 Output CMD device, normally 2 

009B 155 Parity byte from cassette 

009C 156 Tape flag: byte received 

009D 157 I/O messages: 192=all, 64=errors 
0=nil 


OOAO-00A2 160-162 Jiffy clock HMS 
00A3-00A4 163-164 Temporary storage/serial bus 


00A5 165 Pointer: SAVE to tape, help 

00A6 166 Pointer: cassette buffer 

00A7 167 RS-232 input bits,tape sh. count 
OOA8 168 RS-232 counter input bits 

O0A9 169 RS-232 start bit flag 

OOAA 170 RS-232 buffer input byte 

00AB 171 RS-232 input parity 


OOAC-OOAD 172-173 Pointer: screen scroll,cass buf. 
OOAE-OOAF 174-175 Tape end adds/end of program 
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HEX DECIMAL 


DESCRIPTION 


I TE a iE EST I AE LE EE ET TTI 


00BO-00B1 176-177 
00B2-00B3 178-179 


00B4 180 
00B5 181 
00B6 182 
00B7 183 
00B8 184 
00B9 185 
OOBA 186 
OOBB-OOBC 187-188 
00BD 189 
OOBE 190 
OOBF 191 
00C0 192 
00C1 193 
00C2 194 
00C3-00C4 195-196 
00cs 197 
00Cc6 198 
00C7 199 


00C8-00CB 200-203 
OOCC-00CD 204-205 
QOCE-O0CF 206-207 


00D0 208 
o00oD1 209 
00D3 211 
00D4 212 
00D5 213 
00D6 214 
00D7 215 
00D8 216 
00D9 217 
00DA 218 
O0ODB 219 
oopc 220 
0O0DD 221 
0O0DE 222 
OODF 223 


OOEO-O0E1 224-225 


Cassette constant for time 
Vector: tape buffer start 
RS-232 next bit for scroll 
RS-232 next byte for transfer 
RS-232 byte buffer 

Number of character in file name 
Current logical file 

Current secondary address 
Current device 

Pointer to file name 

RS-232 parity buffer 

# of remaining read/write blocks 
Serial buffer 

Tape motor interlock 

Start address input/output, low 
Start address input/output, high 
Pointer: kernal vector address 
Tape read/write data range 

Bank # current LOAD, SAVE, VERIFY 
Bank # current filename, $BB, $BC 
RS-232 input/output buffer addr. 
Keyboard decode pointer (bank 5) 
Pointer: Kernal PRINT routine 
Number of char. in keyboard buf. 
# of programmed char. waiting 
Key shift flag: O=no shift 

Flag for keypress 

Last key code: 88 if no key 
Input from screen/from keyboard 
40/80 columns: 0=40 columns 
Flag/text/graphic screen mode 
Character base: 0=ROM, 4=RAM 
Pointer: MOVLIN (low) 

Pointer: MOVLIN (high) 

Function key number 

String length to current F-key 
Bank /function key call 

String length to current F-key 
Pointer to screen line/cursor 
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HEX DECIMAL 


A ESTP NP BT EE a EE TE TP 


00E2-00E3 
00E4-00E7 


00E8-00E9 
O0OEA 
0OEB 
OOEC 
OOED 
OOEE 
OOEF 
OOFO 
OOF1 
00F3 
OOFS 
OOF6 
ooFs 
0OF9 
OOFA-OOFF 
0100-01FF 
0100-01FF 
0100-0124 
0125-0138 
0200-02A0 
02A2-02AE 
02AF-02BD 
02BE-02CC 
02CD-02E2 
02E3-02FB 
02FC-02FD 
0300-0311 
0302 
0304 
0306 
0308 
030A 
0312-0313 
0314-0315 
0316-0317 
0318-0319 


226-227 
228-231 


232-233 
234 
235 
236 


250-255 
256-511 
256-318 
256-292 
293-312 
512-672 
674-686 
687-701 
702-716 
717-738 
739-763 
764-765 
768-785 
770 

772 

774 

776 

778 

786-787 
788-789 
790-791 
792-793 


DESCRIPTION 


Color line pointer 

Screen margins: bottom, top, 
left, right 

Input cursor log (row,column) 
End/input cursor log(row,column) 
Pos. of cursor on screen line 
Row where cursor lives 

Maximum number of screen lines 
Maximum number of screen columns 
Temporary storage/char. to go 
Mem. last character (ESC test) 
Color under cursor 

Flag: RVS mode active 

Flag: quote mode active 

Flag: auto insert active 
Screen scroll cutoff 

Stop beep tones made by CTRL G 
UNUSED 

Processor stack area 

Tape error log 

DOS work area 

PRINTUSING work area 

BASIC input buffer 

BANK peek subroutine 

BANK poke subroutine 

BANK compare subroutine 

JSR to another BANK 

JMP to another BANK 

Function execute hook 

BASIC links 

BASIC warm start 

Tokenize BASIC text 

BASIC text list 

BASIC character dispatch 
BASIC token evaluation 

UNUSED 

IRQ vector 

Break interrupt vector 

NMI interrupt vector 


LT I EE ER GI TOTES 
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HEX DECIMAL DESCRIPTION 

EL SRS TE GE TS EIT 

031A-032D 794-813 Kernal vectors 

032E-033D 814-829 Kernal links 

033C-037F 828-895 Kernal tables 

033E-0349 830-841 Keyboard matrix shift vectors 

034A-0353 842-851 Keyboard buffer 

0354-035D 852-861 Tab stop bits 

035E-0361 862-865 Line wrap bits 

0362-0368 866-875 Logical file table 

036C-0375 876-885 Device number table 

0376-037F 886-895 Secondary address table 

0380-039E 896-926 CHRGET subroutine 

0386 902 CHRGOT entry 

039F-03D1 927-938 Subroutine to fetch from RAM 
banks 

03DF 991 Accum. #1: overflow 

0400-04FF 1024-1279 VIC text screen (VM #1) 

0400-07E7 1024-2023 40 column screen memory 

0400-FEFF 1024-65279 BASIC variable storage 

O7F8-07FF 2040-2047 Sprite identity area (text) 

O800-O9FF 2048-2559 BASIC run time stack 

0A00-0A01 2560-2561 Vector: BASIC restart 

0A05-0A06 2565-2566 Pointer: Bottom of memory 

0A07-0A08 2562-2563 Pointer: top of memory 

0A18 2584 Pointer: RS-232 receive 

0A19 2585 Pointer: RS-232 input 

OA1A 2586 Pointer: RS-232 transmit 

OA1B 2587 Pointer: RS-232 send 

0A20 2592 Size of keyboard buffer 

0A22 2594 Key repeat, 128 = all,64 = none 

OBOO-OBBF 2816-3007 Cassette buffer 

OBCO-OBFF 3008-3071 (disk boot page) 

OCOO-OCFF 3072-3327 RS-232 input buffer 

ODOO-ODFF 3328-3583 RS-232 output buffer 

OEQO-OFFF 3584-4095 Sprite definition area 

1000-10FF 4096-4351 Function key buffer 

1000-1009 4096-4105 number of bytes per key 

100A Function key strings 

1100-1107 4352-4359 CP/M reset code 

1108-11FF 4360-4607 BASIC DOS/VSP variables 
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HEX DECIMAL DESCRIPTION 
SSS 
11E9-11EA 4585-4586 Light pen values, X and Y 
1200-1201 4608-4609 Previous BASIC line number 
1202-1203 4610-4611 Pointer: BASIC statement CONT 
1204-1207 4612-4615 Punctuation characters (.,$) 
1208 4616 Error type ER 

1209-120A 4617-4618 Error line number EL 

1210-1211 4624-4625 End of BASIC (bank 0) 

1212-1213 4626-4627 BASIC program limit 

1218-121A 4632-4634 USR program jump 

121B-121F 4635-4639 RND seed value 

1400-17FF 5120-6143 Reserved for foreign lang. sys. 
1800-1BFF 6144-7162 Reserved for function key ML 
1COO-FEFF 7168-65279 BASIC program area 

1COO-1FFF 7168-8191 VIC bit-map color 

2000-3FFF 8192-16383 Screen memory (hi-res) 


4000-FBFF 16384-64511 BASIC RAM memory (hi-res) 
4000-FEFF 16384-65279 BASIC program area continued 
FFOO 65280 MMU configuration register 
FFO1-FF04 65281-65284 MMU load config. registers 
FFO5-FF44 65285-65348 Kernal dispatch code 

FFDO 65488 CP/M and kernal RAM code 
FFFA-FFFF 65530-65535 NMI;RST; and IRQ vectors 


BANK C¢1) 0000-O3FF IS THE SAME AS RAM (0) 





0400-FEFF 1024-64511 BASIC variables, strings,arrays 
FFO5-FF44 65285-65348 Kernal int. dispatch code 
FFF5-FFF9 65525-65529 'CBM' and RST address $E224 
FFFA-FFFF 65530-65535 Vectors: NMI, RST, and IRQ 


(cz SE 


BANK 14 SAME AS BANK 15 EXCEPT: © 





DOOO-DFFF 53248-57343 ROM character generator 


BANK 15 


4000-CFFF 16348-53247 ROM: BASIC 
DO00-D030 53248-53296 40- column video chip 8564 
D400-D41C 54272-54300 SID sound chip 6581 
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HEX DECIMAL DESCRIPTION 
el SS SSS 
D500-D50A 54528-54538 MMU 8722 memory setup registers 
D600-D601 54784-54785 80 column CRT control 8563 
D800-D8E7 55296-56295 Color nybbles 

DCOO-DCOF 56320-56336 CIA 1 (IRQ) 6526 

DDOO-DDOF 56576-56591 CIA 2 (NM) 6526 

DFOO-DFOA 57088-57098 DMA controller 

EQOO-FEFF 57344-65279 ROM: kernal 

FFOS-FFFF 65285-65535 ROM: Transfer, jump table 


near eee LE ee 
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C-—-128 KERNAL ROUTINES 


The Kernal ROM is a table of pre-defined subroutines. 
These addresses act as pointers to all the components 
needed to complete each routine. If Commodore changes 
or updates the operating system, these locations stay 
unchanged. Programmers can use this table, knowing a 
program will run on future models of the C-128. 





HEX DECIMAL LABEL ACTION 





$FF4D 65357 C64 MODE Go to 64 mode, no return to 128 
$FF50 65360 DMA-CALL Initialize external RAM 
$FF53 65363 BOOTCALL Boot the disk at startup/insert 
SFF56 65366 PHOENIX Cold start in C-128 mode 
$FF59 65369 LKUPLA Search for logical file number 
SFF5C 65372 LKUPSA Search for secondary address 
SFF5F 65375 SWAPPER Swap from 40 to 80 columns 
SFF62 65378 DLCHR Move char. set for 40/80 column 
SFF65 65381 PFKEY Redefine function keys,SHIFT/ 
RUN-STOP, HELP 
$FF68 65384 SETBNK Define mem. bank for disk drive 
SFF6B 65387 GETCONF Get configuration byte 
SFF6E 65390 JSRFAR Jump to subroutine in any bank 
$FF71 65393 JMPFAR Jump to any bank 
$FF74 65396 INDFET Get byte from any bank 
$FF77 65399 INDSTA Store accumulator in any bank 
$FF7A 65402 INDCMP Compare accumulator with memory 
in any bank 
SFF7D 65405 PRIMM Output text to current device 
$FF81 65409 CINIT Initialize screen editor 
SFF84 65412 IOINIT Initialize input/output 
SFF87 65415 RAMTAS Initialize RAM/tape buffer, 
set screen 
$FF8A 65418 RESTOR Restore default input/output 
vectors 
$FF8D 65421 VECTOR Read/set vectored input/output 
S$FF90 65424 SETMSG Enable/disable DOS messages 
$FF93 65427 SECND Send secondary addr. to LISTEN 
$FF96 65430 TKSA Send secondary address to TALK 
S$FF99 65433 MEMTOP Read and set top of memory 
SFF9C 65436 MEMBOT Read and set bottom of memory 


SR EN I EY ED 
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HEX DECIMAL LABEL 


ACTION 





SFFOF 
SFFA2 
$FFA5 
SFFA8 
$FFAB 
SFFAE 
$FFB1 
SFFB4 
SFFB7 
SFFBA 
$FFBD 
$FFCO 
SFFC3 
SFFC6 
SFFC9 
SFFCC 
$FFCF 
SFFD2 
$FFD5 
SFFD8 
$FFDB 
$FFDE 
$FFE1 
SFFE4 
$FFE7 
SFFEA 
$FFED 
SFFFO 


SFFF3 


65439 
65442 
65445 
65448 
65451 
65454 
65457 
65460 
65463 
65466 
65469 
65472 
65475 
65478 
65481 
65484 
65487 
65490 
65493 
65496 
65499 
65502 
65505 
65508 
65511 
65514 
65517 
65520 


65523 


KEY 
SETTMO 
ACPTR 
CIOUT 
UNTLK 
UNLSN 
LISTN 
TALK 
READST 
SETLFS 
SETNAN 
OPEN 
CLOSE 
CHKIN 
CKOUT 
CLRCH 
BASIN 
BSOUT 
LOADSP 
SAVESP 
SETTIM 
RDTIM 
STOP 
GETIN 
CLALL 
UDTIM 
SCRORG 
PLOT 


IOBASE 


Scan the keyboard 

Set time out flag for IEEE 

Get a byte from the serial bus 
Output a byte to the serial bus 
Command serial bus to UNTALK 
Command serial bus to UNLISTEN 
Command serial bus to LISTEN 
Command the serial bus to TALK 
Read the status of input/output 
Set file parameters 

Set file name parameters 

Open a logical file 

Close a logical file 

Define a file as input 

Define a file as output 

Close input/output channels 
Get char. from input channel 
Output char. to output channel 
Load a file into memory 

Save memory to a file 

Set the system clock 

Read the system clock 

Scan the STOP key 

Get a character from a device 
Close all channels and files 
Increment the system clock 

Get size of current window 
Read and set the X,Y cursor 
position 

Return the base address of 
input/output device 
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CP/M PLUS 3.0 
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Introduction 


Transient utility commands 


COPYSYS 
DATE 


Assignment/logical devices 


Reserved characters 
Reserved file types 
Control codes 


Line editing with control 
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120 
121 
121 
121 
121 
121 
123 
123 
125 
125 
125 
125 
126 
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127 
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130 
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132 
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132 
134 
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136 
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136 
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140 
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CP/M PLUS 


The CP/M ( Control Program for Microprocessors ) Plus 
Version 3.0 operating system within the Commodore 128 
is from Digital Research Inc. The system is loaded in 
to the computer from a disk drive. The software then 
takes control of the C-128 resources, such as memory, 
disk drive, and printer. The main component, of this 
mode is the Basic Disk Operating System (BDOS). CP/M 
Plus can run hundreds of programs, developed for CP/M 
2.2. A large selection of software has been placed in 
the public domain. Ask your local user's group on how 
to contact one of the clubs interested in the field. 


There are two types of commands used in the operation 
of CP/M Plus. Transient commands must be loaded from 
disk before use. Resident Utility commands are built- 
in the CP/M operating system. The following is a des- 
cription of both types of commands. All syntax examp- 
les use the parameters set forth in the opening 
chart. 


NOTE: <> Optional parameters. 
[] Optional parameters, brackets mandatory 
() Indicates a range of options, parenthesis 
must be typed also. 
/ Separates choices for one or more options 
“ or CTRL Control key. 
... May be repeated over and over. 


SYS System attribute. 

* Wild card, replaces any/all of filename 
Wild card, replaces one char. of filename 
Search 
Insert 
String 
Delete 
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CP/M PLUS COMMANDS 





TRANSIENT UTILITY COMMANDS 





COPYSYS 


FUNCTION: Copies CP/M Plus system to another disk. 
FORMAT : COPYSYS 


DATE 


FUNCTION: Displays/enables setting of DATE and time. 
FORMAT : DATE (CONTINUOUS/SET] 
DATE [12/24/85 11:30:0] 


DEVICE 


FUNCTION: Displays or enables setting of DEVICE. 
FORMAT : DEVICE <names/values/phys.-dev/log.-dev> 
DEVICE log. -dev=phys.-dev<option> 
«,phys.-dev<option),...> 
DEVICE log.-dev = NULL 
DEVICE phys.-dev <option) 
DEVICE console[page/columns=#/lines=#] 
OPTIONS : XON : Signals transmission on 
XOFF : Signals transmission off 
NOXON : Indicates no protocol 
BAUD-RATE: Sets speed of drive. Rates are 
as follows; 


50,75,110,134,150,300,600,1200, 
1800, 2400, 3600, 4800, 7200, 9600, 
19200 

DIR 


FUNCTION: Displays the names of files and attributes 
associated with files. 

FORMAT : DIR<d:/filespec/...>{options] 
DIRSYS<d: /£ilespec> 
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OPTIONS : ATT 
DATE 
DIR 
DRIVE = ALL 


DRIVE 


" 
~- 
> 
. 
w 
a 


DRIVE 


u 
o 


EXCLUDE 
FF 


FULL 
LENGTH = n 


MESSAGE 


NOPAGE 


NOSORT 


RO 


RW 


SIZE 


SYS 


USER = ALL 


SER NE A I PIAS SAIS PN IPP ST SE ED ET IEEE ED 


oe 


oo 


ee ce 


oe 


Exhibits user-definable 
keys. 
Exhibits files with 
date and time stamps. 
Exhibits files with DIR 
assigned to them. 
Exhibits all files on 
drive. 


: Exhibits files on spec- 


ified drives. 


Exhibits files only for 
specified drive. 

Shows files not specified 
in command line. 

Sends a line-feed to 
printer if activated 

by CTRL-P. Otherwise, 
turns off default paged 
display. 

Exhibits everything 
connected to a file. 
Displays n lines before 
inserting a heading. 

n = range 5 to 65536 
Shows names of specified 
drives and user# it's 
searching for. 

Turns off paging. 
Exhibits files as listed 
in the directory 

Shows files with Read- 
Only capabilities. 

Shows files with Read- 
Write capabilities. 
Shows filenames and 

size in kilobytes. 

Shows files that have 
SYS specified. 

Shows all files with 
user numbers. 
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DUMP 


FUNCTION: 
FORMAT : 


ED 
FUNCTION: 


FORMAT : 
COMMANDS: 


USER = n : Shows only files with 
user number specified. 

USER = (0,1,...): Shows only files with 
user numbers specified. 


To exhibit contents of a file in HEX/ASCII. 
DUMP filename 


Allows creation and editing of disk files. 


ED <input-filename<d: /output-filename>> 

nA : Append n lines from disk 
file to buffer. 

OA : Append from disk file 
until buffer is half full 

B : Move cursor to top/buffer 

-B : Move cursor to bottom of 
buffer. 

nC : Move cursor n characters 
forward. 

nc : Move cursor n characters 
backwards. 

nD : Delete n characters from 

‘ the cursor position. 
-nD : Delete n characters be- 


fore the cursor position. 
: Save buffer/exit to CP/M3 
Fstring<*z> : Search for string. 
H : Save buffer, then use new 
file as original. 


I : Insert mode, use “*Z or 
ESCape key to exit. 

Istring<*z> : Insert string at cursor 
position. 

Jse str “*z : Look for string before 

ins str*z place to insert new 


del to str<*z> string. Then delete up to 
string right after. 
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nk 

-nK 
nL 

-nL 
L 
nMcommands 
n 

—n 


n: 
sncommands 


Nstring<*z> 


R<“*z> 


R£ilename<“z> 
Sdel str“zins 
str¢*z> 

nT 


-nT 


e 
e 


oe 


e 
o 
° 
. 
e 
e 
e 
e 
e 
e 


Delete n lines from 
cursor. 

Delete n line before 
cursor. 

Move cursor n lines 
forward. 

Move cursor n lines 
backward. 

Skip to next line. 
Execute commands n times. 
Move cursor forward n 
lines and display 

Move cursor backwards n 
lines and display. 

Move cursor to line n. 
Execute command until 
line n. 

Finds first line with 
string. 

Exit to original file. 
Move cursor forward n 
lines/display n lines 
Move cursor backward n 
lines and display n lines 
Exit to CP/M without sav- 
ing buffer. 

Read X$$$$$$$.LIB file 
into buffer. 

Read file into buffer. 
Deletes old string and 
inserts new string. 
Displays n lines forward 
from cursor. 

Displays n lines 
backwards from cursor. 
Displays current line. 
Change to upper case. 
Change to lower case. 


: Line numbering ON. 


Line numbering OFF. 


: Exhibit buffer space left 
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nu : Enter n lines to update 
file. 
nX<“*z> : Write or append n lines 


to X$$$s$$$.LIB. 
nXfilename<*z> : Write n lines to file or 

append if previous X com- 

mand applied to same file 


0X<*z> : Delete LIB file. 

OXfilename<“z> : Delete named file. 

nZ : Wait n seconds. 
ERASE 


FUNCTION: Deletes one or more files from disk. 
FORMAT : ERASE <d:><f£ilename> <«({CONFIRM]> 
ERASE <d:><wildcard> 


GENCOM 


FUNCTION: Creates a COM file with attached RSX files. 
FORMAT : GEMCOM COM-filename RSX-filename...<{LOADER 
/ SCB=(offset, value) ]> 
GENCOM RSX-filename...<{NULL / SCB=(of£set, 
value) ]> 
GENCOM filename(SCB=(offset,value) ] 
GENCOM filename 


GET 
FUNCTION: Tells CP/M to get input from CONSOLE/file 


FORMAT : GETCCONSOLE INPUT FROM>filename <Coptions]> 
GET(CONSOLE INPUT FROM>CONSOLE 


OPTIONS : ECHO : Echos input to screen 
NO ECHO : Turns off ECHO. 
SYSTEM : Takes all SYSTEM input 
from file. 
HELP 


FUNCTION: Provides information files either supplied 
with CP/M or created by the user. 
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LL 


FORMAT : HELP<topic><subtopicl...subtopic8><[NO PAGE 
/ LIST)> 
HELP [EXTRACT] 
HELP [CREATE] 
COMMANDS: CREATE : Builds a revised HELP.HLP from 
HELP. DAT 
EXTRACT : Creates the HELP.DAT file. So you 
can add your help files to the 
master list. 
LIST : Eliminates extra lines between 
headings. 
NO PAGE : Disables the paging option. 


HEXCOM 


FUNCTION: Generates a command file (filename.COM) 
from a HEX file. 
FORMAT : HEXCOM <d:>filename 


INITDIR 


FUNCTION: Initializes a disk directory for date and 
time stamping. 
FORMAT : INITDIR d: 


LIB 


FUNCTION: This utility is used to create, replace, 
delete, select, and append LIB files. 
FORMAT : LIB filename <[options])> 
LIB filename <{options]>=filename<modifier> 


OPTIONS : D : Displays contents of 
object modules in ASCII. 
I : Creates indexed library 
file (filename.IRL). 
M : Displays module names. 
P : Displays module names and 


public variables for 
the new file. 
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MODIFIER: 


LINK 


FUNCTION: 


FORMAT : 


OPTIONS : 
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Delete <module=)> 
Deletes named module. 
Replace <module=filename.REL> 
Replaces module with filename.REL 
Select <lst module-last module) 
The selected modules (lst module thru 
last module) are saved as one file. 
Select <modulel,module2,...> 
The selected modules (modulel, module2, 
...) are saved as one file. 


Combines relocatable objec modules such as 

produced by RMAC and PL/I-80 into a .COM 

file. These files can access modules in 

.LIB files. 

LINK <d:filename,...> 

LINK filename 

LINK d:<filename, <{option] >=) filename 
<Coption]><,...> 


A : Writes temp. data to disk 
and reduces buffer space. 
B : Aligns data segment on 


page border, puts length 
of code segment in header 
(default is .SPR). 

Sets memory address for 
common and data area. 


Dxxxx 


oe 


common and data area. 


q 
=] 


Set start address to n. 
Lxxxx : Change default load add. 
of module to xxxx 
(default = 0100H). 


Mxxxx : Define free memory for 
MP/M modules. 
NL : Disable symbol table 


listing at console. 
Do not create a symbol 
table. 


= 
wa 
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Ec eel 


oc 


OP 


OR 


os 


$Id 


$Ld 


$0d 


$Sd 


. 
e 


oe 


ee 
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Create a .COM command 
file (default). 

Create a .PRL file for 
execution under MP/M in 
relocatable segment. 
Create a .RSP file for 
execution under MP/M. 
Create a .SPR file for 
execution under MP/M. 
Change default program 
load address to xxxx 
(default = 0100H). 

List symbols table with 
leading question mark. | 
Search preceding file as 
library file. 

Send console messages to 
d, where d can be one of 
the following: X=console, 
Y=printer, and Z=no 
output (default = X). 


Source of files is d, 


d can be drives A thru P 
(default = current drive) 
Source of library is d, 
where d can be drives A 
thru P (default = 
Destination of symbol 
file, where d can be one 
of the following: Y=prin- 
ter, Z=no output or disk 
drives A thru P(default 

= same drive as first 
file in LINK-80 command). 
Destination of symbole 
file, where d can be one 
of tje following: Y=prin- 
ter, Z=no output or disk 
drives A thru P(default 

= same drive as first 
file in LINK-80 command). 
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MAC 


FUNCTION: Reads .ASM file, produces three output 
files/filetypes of .HEX, .PRN, >SYM 
(all filenames are the same). 


FORMAT : MAC filename <$options> 
OPTIONS : A : source drive for .ASM 
file (A-0) 

H : Destination drive for HEX 
file (A-0,2). 

L : Source drive for .LIB 
files called by MACLIB 
statement. 

+L : List input from .LIB 
files 

-L : Turn off list from input 
-LIB file (default). 

+M : Display all macro lines 
as they are processed. 

-M : Disable display of macro 
lines processed. 

*M : Display only hex generat- 
ed by macro expansions. 

P : Destination drive for 
-PRN file(s) (A-O,X,P,2) 

+Q : Displays LOCAL Symbols 
in symbols list 

-Q : Disable display of LOCAL 
symbols in list (default 

S : Destination drive for 
-SYM file(s) (A-O,X,P,@). 

+5 : Appends symbol file to 
print file. 

-S : Disables creation of 
symbol file. 

+1 : Produces a pass 1 listing 
for debugging .PRN file. 

-1 : Disables pass 1 listing 
(default). 

ci iii pi 
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PATCH 


FUNCTION: Displays or installs patch number n to CP/M 
system or CP/M command files. 
FORMAT : PATCH filename<filetype><n> 


PIP 


FUNCTION: Performs the following: copy files, 
combine files, transfer files between drive 
printer, console, etc.. 

FORMAT : PIP 
PIP d:<{Gn]>=£ilename<options> 
PIP filename<(Gn]>=filename<options><,...> 
PIP Filename<[Gn])/d:=filename<options) /d: 


OPTIONS : A : Copy files not modified 

since the last copy. 

Cc : Ask for confirmation be- 
fore performing copy. 

Dn : Delete characters past 
column n. 

E : Echo at console. 

F : Disables form-feeds from 
source data. 

Gn : Tells PIP where to get/ 


place source data (n=user 
number, range 0 to 15). 


H : Hex data transfer. The 
console displays error 
messages. 

I : Ignore 00 records in hex 
transfer. 

L : Translates upper to lower 
case in destination file. 

N : Adds line numbers to 
destination file. 

N2 : Adds leading 0's to line 


#s, inserts a tab after 
# in destination file. 
0 : Tells PIP you are combin- 


ing object code files. 
RS TI TS ET TE Te ISTE 
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PUT 
FUNCTION: 


FORMAT : 


OPTIONS : 


Pn : Sets page length, adds 
page eject every n lines 
in destination file. 
(default = 60). 

Stop copying from source 

drive after string s. 

String argument MUST end 

with “z. 

R : Read .SYS files. 

: Begin copying at string s 
from source device. 
String argument MUST end 
with “z. 

Tn : Expanded tabs, positions 

next character in column 
Gividable by n. 

U : Translates lower to upper 

case in destination file. 

V : Verify, to compare 

destination to source. 

W : Writes over files with RO 

attribute. 

Z : Gero parity bit. 


Qs 


Se) 
n 


Directs console or printer output to one of 
the following; CONSOLE, PRINTER, or FILE. 
PUT CONSOLE<OUTPUT> filename<{option]> 

PUT CONSOLE<OUTPUT> CONSOLE 

PUT PRINTER<OUTPUT> filename<[{option]> 

PUT PRINTER<(OUTPUT> PRINTER 


ECHO : Echo output to console 
(default). 
FILTER : Translate control char. 


to printable characters. 


NO ECHO : Turn echo of€. 
NO FILTER : Turn filter off (default) 
SYSTEM : Write output to specified 


file. 
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RENAME 


FUNCTION: Renames a file on disk. 
: RENAME <new-filename = old-filename> 


Assembles files (.ASM) into files (.REL) 
that can be linked to create .COM files. 
RMAC filename <options> 


: d : Where d equals destination 


of output. Drives A thru 0 
P = printer, X = console, 
2 = no output. 


Pd ‘; Output for .PRN file, d = 
A-O, P, X, Z. 

Rd : Output for .REL file, d = 
A-0O, Z. 

Sd : Output for .SYM file, d = 
A-O, P, X, Z. 


Saves the contents of mem. to a file. Asks 
for filename, starting/ending add. To use 
command, first give the SAVE command next 
run your program that alters memory/loads 
info into mem. If program exits, SAVE 
command takes control. 


: SAVE 


The SET command performs the following; 
initiates protection/time stamping of files 
sets file, drive attributes RW, RO, DIR, 
SYS, label a disk/password protection on 
disk labels. 

SET <d:> {options/option=modifier ]} 

SET filename [options/option=modifer ] 
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PASSWORD 
OPTIONS : PROTECT=ON : Enables password protect- 
ion for files on disk. 
PROTECT=OFF : Disable password protect- 
ion for all files on disk 
PASSWORD=password : Assigns a password to a 
file. 
PROTECT=READ : Password for read, write 
copy, rename, delete file 
PROTECT=WRITE : Password for write,rename 
deleting a file. 
PROTECT=DELETE : Password for deleting or 
renaming a file. 
PROTECT=NONE : No password needed to 
modifications to the file 
FILE 


OPTIONS : ARCHIVE=0N 
ARCHIVE=OFF 


File has been backed-up. 
File is not backed-up. 


DIR : Assigns .DIR to file. 
F1=0N : User-definable file on. 
F1=0FF : User-definable file off. 
F2=0N : User-definable file on. 
F2=0FF : User-definable file off. 
F3=0N : User-definable file on. 
F3=0FF : User-definable file off. 
F4=0N : User-definable file on. 
F4=0FF : User-definable file off. 
RO : Sets file to Read Only. 
RW : Sets file to Read Write. 
SYS : Assigns .SYS to file. 
TIME-STAMP 
OPTIONS : ACCESS=ON : Enables recording of last 
access of file. 
ACCESS=0FF : Stops recording of last 
access of file. 
CREATE=0N : Enables recording of 
creation time of file. 
CREATE=OFF : Disables recording of 


creation time of file. 
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UPDATE=ON H 


UPDATE=O0FF 


SETDEF 


Enables recording of last 


‘modification of file. 
: Disables recording of 


last modification. 


FUNCTION: To Display/disk, search order, temp. drive, 
filetype search order. 


FORMAT : SETDEF 


SETDEF <{DISPLAY/NO DISPLAY/PAGE/NOPAGE]> 


SETDEF <d:¢,d:¢,d: 


€,d:>>)><{TEMPORARY=d:] / 


C[ORDER=(type<, type> ) ] 


SHOW 


FUNCTION: Displays information from diskette in drive 
FORMAT : SHOW <d:><(SPACE/LABEL/USERS/DIR/DRIVE]> 


SID 


FUNCTION: Allows debugging of M/L programs. 
FORMAT : SID <filename.type><, filename .SYM> 


COMMANDS: 
As 3 
Cs<b<,d>> 3 
D<W><s>¢,e) 


Efilename.type : 


E*filename.SYM 
Fs,e,d 


ee ce 





Assemble code starting at 
add. s 

Identifies mem. location 
s for SID, b= value of BC 
register pair, d = DE reg 
ister pair. 


: Shows mem. in HEX/ASCII 


W specifies 16-bit format 
s = starting address, e = 
ending address. 

Load program/symbol 

table for execution. 

«, filename. SYM> 

Load symbol table only. 
Fill mem. Where s = start 
ing add., e = end add., 

d = 8-bit data item. 


aS I 
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G<s)¢,a¢,b>> 


GO 


Ha 
Ha,b 
Icommand tail 


Lés><,e> 


Ms,e,n 


P¢p<,x>> 


Rfilename<,x> 


S<Ws 


Tin¢,x>>d 


TCW) <n¢,x>> 


UCW> <n<,x>> 


oe cf 


ee 
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Begin execution at s 
(starting address), a = 
lst temporary breakpoint, 
b = 2nd temp. breakpoint. 
Exits SID by a warm start 
Shows symbols/addresses 
in hex. 

Displays hex, dec., ASCII 
values of a. 
Displays hex sum, differ- 
ence of a and b. 

Enter CCP command. 

List 8080 instructions, 

s = starting address, 

e = ending address. 

Move a section of memory, 


s = starting address, 
e = ending address, 
n = new starting address. 


Pass point set, reset, 
display. Where p = per- 
manent breakpoint address 
x = value of pass counter 
Read code/symboles from 
file, x = offset to each 
address. 


: Set memory values, s = 


address where value is 
sent, W = 16-bit word. 
Turn trace on, n = # of 
program steps to trace, 

x = utility entry address 
Turn trace on without 
call, § = SID no trace 
subroutines. n = # of 
program steps to trace, 

x = utility entry address 


: Trace off, 8 = SID not to 


trace subroutines, n = # 
of program steps to trace 
x = utility entry address 


aT I ST ED 
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V : Shows value of next avail 
able location in memory. 

Wfilename<,s,e> : Write a segment of memory 
to filename, s = starting 
address, e = ending add.. 

X¢£> (rd : Examine or alter CPU. £ = 
flag bit for one of the 
following; C, E, I, M, or 
Z. r is one of the 
following registers; A, B 
D, H, P, or S. 


SUBMIT 


FUNCTION: 


FORMAT. : 
TYPE 
FUNCTION: 
FORMAT 
OPTIONS : 
USER 
FUNCTION: 
FORMAT : 
XREF 
FUNCTION: 


FORMAT : 
OPTIONS : 


Executes a group of commands in a .SUB file 
Information may be passed to a .SUB file by 
using the argument option. Up to nine 
pieces of info maybe passed in this manner. 
SUBMIT <filename><argumentl,...argument9> 


Displays contents of a ASCII file to screen 


: TYPE <filename<[(options]>> 


PAGE — : Turn paging on. 
NO PAGE : Turn paging off. 
Enables setting of current USER number. 


User numbers are in the range of 0 thru 15. 
USER <number> 


Provides a cross-reference of variables 
used in a program. XREF requires the .PRN 


“and .SYM files created by MAC or RMAC for 


the specified file. 
XREF <d:> filename <option) 
$P : Sends output to printer. 
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RESIDENT UTILITY COMMANDS 





DIR 

FUNCTION: Display files on current disk drive, except 
files marked with .SYS. 

FORMAT : DIR 

DIRSYS 


FUNCTION: Displays all files marked with .SYS 
FORMAT : DIRSYS 


ERASE 

FUNCTION: Deletes a file from the current disk drive, 
releases the allocated space for that file. 

FORMAT : ERASE filename 

RENAME 


FUNCTION: Renames a file on the current disk drive. 
FORMAT : RENAME <new-filename=old-filename> 


TYPE 

FUNCTION: Displays the contents of a ASCII file on 
the screen. 

FORMAT : TYPE filename 

USER 


FUNCTION: Enables setting of current USER number. 
User numbers are in the range of 0 thru 15. 
FORMAT : USER <number> 
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ASSIGNMENT/LOGICAL DEVICES 


The minimum equipment requirement, for the C-128 CP/M 
3.0 system is a console ( keyboard plus monitor ) and 
a disk drive. Other devices may be added to the group 
as your system grows. The following chart, lists the 
names of logical devices and their assignment. 








LOGICAL PHYSICAL DEVICE 
DEVICE NAME DEVICE TYPE ASSIGNMENT 

CONIN: Console input Keyboard 

CONOUT: Console output 80 column screen 

AUXIN: Auxillary input Null 

AUXOUT: Auxillary output Null 

LST: List output | PTR1 or PTR2 





RESERVED CHARACTERS 


The characters in the following table are used by the 
CP/M operating system. They are not to be used except 
where indicated. 








CHARACTER DEFINITION 

«$, ! J] > 0) File specification delimiters 

tab space " " " 

carriage return " " . 

: Drive delimiter in file specification 

F Filetype delimiter in file spec. 

; Password delimiter in file spec. 

; Comment delimiter at start of a 
command line 

x ? Wildcard characters 

Oe fd - Option list delimiters 

] List option delimiters, global and 
local options 

() Delimiters for multiple modifiers 
inside [],options that have modifiers 

/$ Option delimiters in a command line 
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RESERVED FILE TYPES 


A three character file type, may be added to the name 
of a file. A number of categories, have been defined 
by the developer and are listed below. 





FILE TYPE DESCRIPTION 
ON 
ASM Assembler source file 

BAS BASIC source program 

COM 280 or equivalent machine language program. 
HEX Output file from MAC (used by HEXCOM) 

HLP HELP message file 

$$$ Temporary file 

PRN Print file from MAC or RMAC 

REL Output file from RMAC (used by LINK) 

SUB List of commands, executed by SUBMIT 

SYM Symbol file from MAC, RMAC or LINK 

SYS System file 





CONTROL CODES 


CP/M Plus 3.0 supports a number, of different CONTROL 
key functions. To implement one of the following op- 
erations, press the CONTROL key plus a designated key 
at the same time. 

ics shee 


CONTROL Plus UPPER cursor key, to scroll right 
to view entire screen in 40 column mode. 

CONTROL S$ Pause scrolling when viewing the screen. 

CONTROL Q ‘To restart scroll after it has been stop- 
ped by CONTROL command. 

CONTROL P This commands send all output from the 
console to the printer. Press the keys 
again to stop output to the printer. 

CONTROL DIR To list a directory of files from the 
disk to the printer. 

CONTROL H Use this command or INST/DEL key to cor- 
rect typing errors. 

CONTROL C To end program run/reset the disk system. 

a Sa 
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LINE—-EDITING with CONTROL 





KEY ACTION 





CONTROL A Moves the cursor one space to the left. 

CONTROL B Moves the cursor to start of line, if 
cursor is at start, moves to the end. 

CONTROL E Forces a physical return without command 
to CP/M 3.0. Allows user to enter code 
and not be executed until user is ready. 

CONTROL F Cursor on character to the right. 

CONTROL G Moves character on the right one space 
left, deletes left character as it moves. 

CONTROL H Deletes character to left of cursor, 
characters to right move one space left. 

CONTROL I Moves cursor to the next tab stop. 

CONTROL J Has the same effect as a carriage return 
or CONTROL M 

CONTROL K Deletes to the end of line from cursor. 

CONTROL M_ Has the same effect as a carriage return 
or CONTROL J. 

CONTROL R- Duplicates current line of code. 

CONTROL U Deletes current line of code, prints # at 
cursor position. 

CONTROL W Recalls previous line. 

CONTROL X Deletes all characters left of cursor. 
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1541 DISK DRIVE 


1541 Specifications 
Diskette Format 
Sector Distribution 
1541 BAM 
1541 Directory Header 
Directory Format 
Error Checking 
Change Device Number 
DOS Wedge Commands 
1541 File Types 
1541 File Formats 

PRG File Format 

SEQ File Format 

REL File Format 

REL Side Sector Format 
File Commands 

SEQ File Commands 
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1541 SPECIFICATIONS 
Drives per unit 


1 
Heads per drive 1 


FORMATTED STORAGE 


Capacity per unit 170 K 
Max # SEQ files 168 K 
Max # REL files 167 K 
Disk system buffer . 2K 


DISK FORMAT 


Tracks . 35 

Sectors per track 17-21 

Bytes per sector 256 
‘Blocks free per unit 664 


ACCESS TIMES (milli-seconds) 


Track-to track 30 
Average track 360 
RPM 300 
PHYSICAL DIMENSIONS ELECTRICAL 

Height (inches) 3 Power (watts) 35 

Width (inches) 7 Voltage 110-120 
Depth (inches) 13 VAC. 60 hz. 


Weight (pounds) 10 





DISKETTE FORMAT 





The diskettes you purchase are totally blank. This is 
so they are generic to many types of disk drive. Each 
buyer must format the disks for their own unit. When 
in C-64 mode, the command is the NEW command. As the 
format process takes place, the diskette is sectioned 
into tracks and made ready to receive information. A 
directory (DIR) and Block Availability Map (BAM) are 
created on track 18 of the diskette. The directory is 
much like the table of contents of a book. Everytime 
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a file is recorded to the disk, it is recorded in the 
directory. When the disk is accessed, the drive looks 
at the DIR as a road map of the diskette. The BAM is 
another kind of map of the diskette. It indicates the 
blocks that have been used, and ones that are vacant. 


The command to format a diskette is as follows: 


OPEN 15,device #,15,"NEW drive#:diskette name,ID" 
CLOSE 15 


The diskette name is your choice, up to 16 character 
spaces. The ID can be any two characters, so long as 
they do not form a key-word. It is best, that all of 
your ID's be different, so as to not confuse the disk 
drive. If you were to attempt to move a file from one 
disk to another, and both had the same ID's, the disk 
drive would not know where the file should go. 


The following charts show the layout of the diskette 
after the format command has taken place. Track one 
is located at the outter edge of the diskette, track 
35 at the center. 


of tracks per diskette 
of blocks per diskette 


of blocks reserved (BAM/DIR) 
of blocks available to user 





SECTOR DISTRIBUTION 


TRACK NUMBER NUMBER of SECTORS 
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1541 BAM 
( Block Availability Map ) 


Track 18, Sector 0 
| BYTES | CONTENTS DEFINITION 


Pointer to the track of 
the next directory entry. 
Pointer to the sector of 
the next directory entry. 
ASCII character A indicat- 
ing 1541 format. 

Flag, double-sided disk 
not used in 1541 mode 
Block Availability Map 



















1541 DIRECTORY HEADER 


Track 18, Sector 0 


| BYTES | CONTENTS ACTION 


144-159 Diskette name padded with 
shifted spaces. 
Shifted spaces. 















160-161 















162-163 Diskette ID 
164 Shifted space. 
165-166 DOS version/format type. 
167-170 Shifted spaces. 
171-255 Unused. 


DIRECTORY FORMAT 


The identifying name, type, location, and length of 


individual files on a disk, are listed on track 18 as 
shown below. 
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Track 18, Sector 1 


DEFINITION 


Track and sector of next directory block. 


File number 
File number 
File number 
File number 
File number 
File number 
File number 
File number 


one 
two 
three 


four 
five 
six 
seven 
eight 





ERROR CHECKING 


When a disk error happens, the light on the front of 
the disk drive will flash red. To identify the 
problem, type in the following: 











EXAMPLE: 
10 OPEN15,8,15 


20 INPUT#15,E1$,E2$,E3$,E4$ 
30 PRINT E1$,E2$,£3$,E4$ 


40 CLOSE15 


CHANGE DEVICE NUMBER 


To make a temporary change of device number, type the 


following: 


PRINT#15, "M—-W"CHRS$(119)CHR$(0)CHRS(2) 
CHRS$(new drive#+t32) 
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DOS WEDGE COMMANDS 


The DOS SUPPORT or WEDGE program offers the user many 
short cuts to disk operation. First LOAD and RUN the 
program. You may now use the commands found below in- 
place of conventional BASIC 2.0 disk commands. 


@$ or >$ To display the directory 

@ or > Disk status, reads error 
channel 

* filename Load and automatic run 

/ filename Load program 

% filename Load file at it's own 


address 
filename Save file 
@ NO:disk name,ID To format a disk 
@ NO:disk name To rename the directory 
@ SO:name of file Scratch or remove file 
@ VO To validate the disk 
@ RO:old name=0:new name To rename a file 





1541 FILE TYPES 





There are several different types of files that may 
be recorded to disk. Each appears in the directory by 
a specific name. If you go a bit further and examine 
the first two bytes of each file, the second identi- 
fies the file type in hexadecimal. 


FILE TYPE DIRECTORY APPEARS HEX 


Scratched not shown 
Deleted (DEL) DEL 
Sequential (SEQ) | SEQ 
Program (PRG) PRG 


User (USR) USR 
Relative (REL) REL 
Open DEL not shown 
Open SEQ *SEQ 
Open PRG *PRG 
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Open USR *USR 
Open REL not apply 
DEL @ replacement} DEL 

SEQ @ replacement] SEQ 

PRG @ replacement] PRG 

USR @ replacement 


REL @ replacement} not apply 
Locked DEL DEL¢ 
Locked SEQ SEQ< 
Locked PRG PRG< 
Locked USR USR< 
Locked REL REL¢ 





1541 FILE FORMATS 


ee cn ee 
The three primary types of files stored upon disk are 
PROGRAM (PRG), SEQUENTIAL (SEQ), and RELATIVE (REL). 
The PRG format is generally used for programs that do 
not store user input to the disk. The SEQ data file 
is an efficient method of information storage. This 
type of files are referred to as sequential, because 
pieces of information are stored one after another. 
When data is stored in this manner, the complete file 
must be brought into the computer memory in entirety 
to be adjusted. The REL data file is well suited for 
extensive amounts of information and allows for fast 
access of data. Individual records from within the 
file, may be brought into memory. Each type has it's 
advantages. As each file type handles data in a diff- 
erent manner, the disk format must also be unique to 
the type of file. 
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PROGRAM (PRG) FILE FORMAT i 


DEFINITION 


SECTOR 1 i 
0,1 Track and sector of next block in file 1. 
2,3 Load address of the program 
4-255 Program information as in memory. 


REMAINING SECTORS 
0,1 Track and sector of next block in file 1. 
2-255 Program information as in memory. 


LAST SECTOR 
0,1 Null-followed by # of data bytes in sector 
2-?? Last bytes of information as in memory. 
End of file is marked by 3 zero bytes. 





SEQUENTIAL (SEQ) FILE FORMAT 


’ DEFINITION 


ALL EXCEPT LAST SECTOR 
0,1 Track and sector of next SEQ data block. i 
2-255 254 bytes of data. 


LAST SECTOR L 
0,1 Null-followed by # of data bytes in sector 
2-?? Last bytes of data. 





RELATIVE (REL) FILE FORMAT 


BYTE DEFINITION 


DATA BLOCK 
Track and sector of next data block. 


254 bytes of data. The first byte of an 
unused record contains $FF followed by 
$00 to the end of record. Partial records 
are completed with zeros. 
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RELATIVE FILE, SIDE SECTOR FORMAT 


Track and sector of next side sector block 
Side sector number (0-5). 


Record length. 

Track & sector pointer 
sector. 

Track & sector pointer 
sector. 

Track & sector pointer 
sector. 

Track & sector pointer 
sector. 

Track & sector pointer 
sector. 

Track & sector pointer 
sector. 


of first (#0) side 
of second (#1) side 
of third (#2) side 
of fourth (#3) side 
of fifth (#4) side 


of sixth (#5) side 


Track & sector pointers to 120 data blocks 
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FILE COMMANDS 


Data files store information to be used by a program. 
SEQuential or RELative files, save the information to 
a diskette. Both are generic in that they may be read 
by many different programs. For an example, data that 
is saved by a word processor, may be stored, as a SEQ 
file and read by several brands of program. 


SEQ files are more efficient in the use of disk space 
than REL files. Data stored in SEQ files is stored in 
order received, one after the other. Where as, with a 
REL file, you can tell the disk drive, where to place 
the information. To retrieve stored information, the 
entire SEQ file must be moved into memory. Access to 
a single record, within a file is possible with a REL 
file. The pros and cons go on, choice is dependent on 
the intended use. 


The commands below, are used to create SEQ, and REL 
files. 





SEQ FILE COMMANDS 





APPEND 350 OPEN#1,8,1,"data file,s,a" 
Open a SEQ file for appending to. 

GET# 385 GET#1,a$ 
Used to read 1 byte from SEQ file set up for read. 
INPUT# 390 INPUT#1,a$ 
Used to read 1 record from SEQ file set up for read. 
M mode 395 openl,8,2,"data 1,s,M" 

Enables recovery of data from open SEQ file. 
PRINT# 380 PRINT#1,a$ 


Writes to already open SEQ file set for write. 
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SEAT IESE TE IE I TE LAE IE TES TOT TEIN I BEERS ST ETE EOI PEI TE NEEL EE TE EL TELE INERT EOE AES IORS, 
READ 360 open#1,8,1,"data file,s,R" 
Open a SEQ file for reading. 


WRITE 370 open#1,8,1,"date file,s,¥" 
Open a SEQ file for writing. 





REL FILE COMMANDS 





OPEN 350 OPEN#1,"data",1[record len],D0,U8 
Open a REL file or create one. 


GET# 370 GET#1,a$ 
Used to read 1 byte from a REL File. 


INPUT# 375 INPUT#1,a$ 
Used to read 1 record from a REL file. 


Pp 395 print#15,"P"+chr$(2)+chr$(r1)+chr$(rh) 
Positions the drive at the right record. 
NOTE: The P command should be used twice. 


PRINT# 400 PRINT#1,a$ 
Used to write to an opened REL file. 
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DIRECT ACCESS COMMANDS 


The DIRECT ACCESS commands read or write data to spe- 
cific sectors. These commands are entirely controlled 
by the user. These are excellent when used in utility 
programs to view or alter locations on a diskette. 

LE TS TE PE EE a ET 
BLOCK—ALLOCATE 390 print#15,"B-A";0;1;1 
Marks a sector as used. 


BLOCK—FREE 400 print#15,"B-F";0;1;1 
Used to free a sector. 


BLOCK—READ 360 print#15,"B-R";2;0;10;12 
Moves 1 block of data into selected buffer. 


BLOCK—-WRITE 370 print#15, "B-W";2;0;10;12 
Writes 1 block of data to the selected disk sector. 


BUFFER-—POINTER = 380 print#15,"B-P";2;1 
Points to where next READ/WRITE begin in disk buffer 


OPEN# 350 OPEN#2,8,2,"#" 
Open a channel and assign any buffer. 


Ul 360 print#15,"U1";2;0;10;12 
Moves 1 block of data into selected buffer. More 
reliable then the 'BLOCK-READ' command. 


U2 370 print#15,"U2";2;0;10;12 
Writes 1 block of data to the selected disk sector. 
More reliable then the 'BLOCK-WRITE' command. 





INTERNAL DISK COMMANDS 


The following commands can alter routines that reside 
within the 1541 disk drive. An accomplished program- 
mer can write machine language programs directly into 
disk memory. A memory map in the back of this section 
identifies many locations useful with these commands. 


EE IE ET I PE TT ET TD TEP LE DI SBE TIS FANE 
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SG ED EE I IE TE a 
BLOCK—-EXECUTE 420 print#15,"B-E";3;18;0 
Rarely used, allows loading a sector into disk 
memory and execution. 


MEMORY —-EXECUTE 410 print#15,"M-E" 

chr$(L add)chr$(H add) 
Allows execution of any routine in disk memory, RAM 
or ROM. L = low memory add., H = high memory add. 


MEMORY—READ 390 print#15,"M-R" 

chr$(L add)chr$(H add) (chr$(bytes) } 
Allows selection of which byte/bytes to read from 
disk memory. 


MEMORY —-WRITE 400 PRINT#15, "M-W" 
chr$(L add)chr$(H add) 
Allows writing up to 34 bytes at once into disk mem. 


User Commands Function 
el 
ua Restores default user jump table. 
Ul or UA Block read replacement. 
U2 or UB Block write replacement. 
U3 or UC Jump to $0500. 
U4 or UD Jump to $0503. 
US or UE Jump to $0506. 
UG or UF Jump to $0509. 
U7 or UG Jump to $050C. 
US or UH Jump to $050F. 
U9 or UI Jump to ($FFFA) reset tables. 

: or UT Power up vector. 


EXAMPLE  : 430 print#15,"Ucharacter"; 





=: 53 


<«-- 1541 MODE LIGHT GREEN --> 


GCR CONVERSION 





GCR is the method in which data is magnetically 
written to the diskette. Encoding involves breaking 
up each 8 bit byte (binary) into two 4-bit nibbles. 
The 5-bit equivalent for each nibble can then be 
found by looking at the table below. The resulting 10 
bits are stored in two consecutive memory locations. 


0 
1 
2 
3 
4 
5 
6 
7 
8 
9 


NOOO PWN Ee © 
ANNDU PWN FE 
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BASIC 2.0 COMMANDS 


The following are the commands from BASIC 2.0 that 
pertain to the 1541 disk drive. 


EI SE TAI EE ES ST SC ATES 


CLOSE PRINT#15:CLOSE15 
To close channel that has been opened to receive data 


CMD CMD1 
To redirect screen output to a disk file. 


COPY PRINT#15,"C:new file=old file" 
To make a copy (duplicate) of a file. 


GET # 
To read one byte from a record. 


INITIALIZE PRINT#15, "I" 
Returns the disk drive to power-up condition. 


INPUT# GET#5,a$ 
Reads a whole record from the disk. 


LOAD. socc- er oS ES Ss 


LOAD"file name",8 Load a BASIC program. 

LOAD" *",8 Load first program of DIR. 
LOAD"file name",8,1 Load machine language program. 
LOAD"file name",8,3 Automatic load and run. 


LOAD"$",8 Loads directory of disk. 

LOAD"A$",8 Loads contents of variable (A$) 

LOAD"T*",8 Loads first file beginning 
with 'T', 

LOAD" JAN*",8 Loads first file beginning 
with "JAN', 


NEW od bad os - - eo oe a io » eo - oo C4 oo 
PRINT#15,"N:name,ID" To NEW a disk (format). 
PRINT#15, "N: name" To clear a directory. 

SE PS A IE TT I I ES BI TEES DE I ESE EL ED, 
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OPEN OPEN 15,8,15 
Opens a file or channel for input or output. 


PRINT# PRINT#5, p$ 
To output data to file or channel. 


RENAME PRINT#15,"R:new name=old name" 
To rename a file on a diskette. 


SAVE SAVE"file name",8 
To SAVE a file in memory to disk. 


SAVE/ REPLACE SAVE"@:file name",8 
To SAVE a new program and replace old. 


SCRATCH PRINT#15, "S:name" 
To erase (SCRATCH) a file. 


VALIDATE PRINT#15, "V" 
To re-organize, collect scattered blocks and make 
space available on the diskette. 


VERIFY VERIFY"file name",8 
To compare a saved file with one in memory 





ee 
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1541 DOS ERROR MESSAGES 


Errors are evaluated by the DOS when come upon during 
a read or write function. What follows are error mes- 
sages that are generated if an error is found. Don't 
panic, evaluate the situation carefully. Some errors 
may also be caused by equipment failure. Check all of 
the cable connections. Also check your electical out- 
let grounded, it MUST be grounded. 

ERROR # MESSAGE and EFFECT 

0 Everything is OK, no error exists 

1 This is not an error, denotes file scratched 

2-19 Unused error messages, ignore 

20 READ ERROR, block header of requested block 
not found. Cause, either illegal block number 
or destroyed header. 

al READ ERROR, sync mark missing. Cause, read- 
write head out of alignment, no disk in drive, 
disk not formatted. 

22 READ ERROR, data failed to match against a 
preset data block identifier. 

23 READ ERROR, checksum error in data block did 
not match checksum read from the disk. 

24 READ ERROR, byte decoding error. Hardware 
error created due to bad bit pattern in the 
data byte. 

25 WRITE ERROR, write verify error. There is a 
mismatch between data just written and data 
in RAM when compared. 

26 WRITE PROTECT ON, a write protect tab is over 
the notch in the side of the disk. Remove to 
write to the disk. 

27 READ ERROR, checksum error in header. There 
is an error in the header of the requested 
data block. 

28 WRITE ERROR, long data block. A sync mark has 
not been found, cause bad format. 

29 DISK ID MISMATCH, a comparison of ID ina 
header block has been made, it does not match 
the master copy of the disk ID. 
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ee CSE SIE TELE EI I I TS I SI ET ST 


ERROR 


MESSAGE and EFFECT 


LETT TE a Se a a EY 


SYNTAX ERROR, the DOS cannot understand the 
command sent to the command channel. 

SYNTAX ERROR, the DOS cannot recognize the 
command. Command must begin in the first space 
SYNTAX ERROR, invalid command. A command has 
been sent that is longer than the allowable 

58 characters. 

SYNTAX ERROR, invalid file name. Pattern 
matching may not be used with the OPEN or SAVE 
command. 

SYNTAX ERROR, no file given. The file name has 
been left out of the command. 

SYNTAX ERROR, invalid command. Command is not 
recognized by the DOS. 

RECORD NOT PRESENT, the disk has been ask by 
an INPUT#, OR GET# to read past the last 
record. 

OVERFLOW IN RECORD, PRINT# statement exceeds 
the defined size. 

FILE TOO LARGE, record position within a REL 
file indicates that disk overflow will result. 
WRITE FILE OPEN, attempt made to open a file 
that is already open. 

FILE NOT OPEN, attempt made to access a file 
that is not open. 

FILE NOT FOUND, the file does not exist on the 
indicated drive. Common cause, in-correct file 
name. 

FILE EXISTS, attempt made to save a file by a 
name that already exists on the disk. 

FILE TYPE MISMATCH, requested file type does 
not match type recorded on the directory. 

NO BLOCK, block has been previously allocated. 
ILLEGAL TRACK AND SECTOR, attempt made to 
access a track or sector that does not exist 
in the format being used. 

ILLEGAL SYSTEM TRACK OR SECTOR, indicates an 
illegal track or sector. : 
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LT TP PE TE SE SE PO 


ERROR # MESSAGE and EFFECT 
A GR PT ST TSE EE TE 


70 


NO CHANNEL, requested channel is not available 
, channel may be in use. SEQ files are limited 
to three files open at one time. Direct access 
channels are limited to six. 

DIRECTORY ERROR, BAM (block availability map) 
does not match internal count. 

DISK FULL, all blocks have been used or the 
directory has reach capacity (144 entries). 
DOS MISMATCH, The diskette has been written by 
another DOS. You may read the disk but not 
write to it. 

DRIVE NOT READY, there is no diskette in the 
drive or the drive is not on line. 


en ene enna 
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HEX LABEL FUNCTION 

$0000 JOBS Job Que: Buffer 0 
$0001 Buffer 1 
$0002 Buffer 2 
$0003 Buffer 3 
$0004 Buffer 4 
$0005 Buffer 5 
$0006 HDRS Job headers: Buffer 0-low 
$0007 Buffer 0-high 
$0008 Buffer l-low 
$0009 Buffer l-high 
SO00A Buffer 2-low 
$000B Buffer 2-high 
$000C Buffer 3-low 
$000D Buffer 3-high 
$000E Buffer 4-low 
$O00F Buffer 4-high 
$0010 Buffer 5-low 
$0011 Buffer 5-high 
$0012 DSKID Master copy disk ID: Drive 0 
$0013 Drive 0 
$0014 Un-used drive l 

$0015 Un-used drive l 

$0016 HEADER Image last header: ID byte 1 
$0017 ID byte 2 
$0018 Track 
$0019 Sector 
SOO1A Checksum 
$001B ACTJOB Controllers active job 

$001C WPSW WP change flag: Drive 0 
$001D Un-used Drive 1 
$001E  LWPT Last state of WP switch: Drive 0 
$OO1F Un-used Drive 1 
$0020 DRVST Drive current status:Drive 0 
$0021 Un-used 

$0022 DRVTRK Drive track number: Drive 0 
$0023 Un-used Drive 1 
$0024 STAB Storage table GCR conversion 


nO 
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1541 RAM 
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HEX LABEL FUNCTION 

$0025 Continued: storage table GCR 
$0026 Continued: storage table GCR 
$0027 Continued: storage table GCR 
$0028 Continued: storage table GCR 
$0029 Continued: storage table GCR 
$002A Continued: storage table GCR 
$002B Continued: storage table GCR 
$002C Continued: storage table GCR 
$002D Continued: storage table GCR 


$002E  SAVPNT Temporary save pointer location 
$002F 
$0030 BUFPNT Pointer to active buffer 


$0031 Cont: pointer to active buffer. 
$0032 HDRPNT Header pointer: track 
$0033 Header pointer: sector 


$0034 GCRPNT GCR pointer 

$0035 | GCRERR Indicates GCR decode error 
$0036 BYTCNT Byte counter GCR/binary conver. 
$0037 BITCNT Bit counter 

$0038 BID Data block ID character 

$0039 HBID Header block ID character 

$003A CHKSUM Data or header checksum 

$003B  HINIB Un-used 

$003C BYTE Un-used 

$003D DRIVE Drive number, $00=1541 

$003E  CDRIVE Current active drive number 
$003F  JOBN Current job number 

$0040 TRACC Track-internal storage location 
$0041 NXTJOB Next job 

$0042 NXTRK Next track to move head to 
$0043 SECTR Sectors per track for formatting 


$0044 WORK Temporary work storage location 
$0045 JOB Temporary storage of job type 
$0046 CTRACK Un-used 

$0047 DBID Data block ID 


$0048 ACLTIM Timer for acceleration of head 
$0049 SAVSP Temporary save of stack pointer 
$004A STEPS # steps to move head to track 
$004B TMP Temporary storage location 


ERS A 2 A BPE BT EE EE PEPE I STD 
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HEX LABEL 
$004C CSECT 
$004D NEXTS 
$004E NXTBF 
$004F NXTPNT 
$0050 GCRFLG 
$0051 FINUM 
$0052 BTAB 
$0053 
$0054 
$0055 
$0056  GTAB 
$0057 
$0058 
$0059 
$005A 
$005B 
$005C 
$005D 
S0O05E AS 
SOOSF AF 
$0060 ACLSTP 
$0061 RSTEPS 
$0062 NXTST 
$0063 
$0064 MINSTP 
$0065  VNMI 
$0066 
$0067 NMIFLG 
$0068 AUTOFG 
$0069 SECINC 
$006A  RECCNT 
$006B USRJMP 
$006C 
$006D BMPNT 
$006E 
$006F TO 
$0070 8§6Tl 
$0071 T2 
$0072 73 


FUNCTION 


Current sector 

Next sector 

Pointer to next GCR source buffer 
Ptr/next byte location in buffer 
GCR/binary flag in active buffer 
Current format flag 

Binary table:GCR/binary work area 
Continued: binary table 
Continued: binary table 
Continued: binary table 

GCR table: GCR/binary work 
Continued: GCR table 

Continued: GCR table 

Continued: GCR table 

Continued: GCR table 

Continued: GCR table 

Continued: GCR table 

Continued: GCR table 

# of steps to used to accel. head 
Acceleration factor 

Steps to go before complete 
Number of run steps left 

Pointer to stepping rtn-$FA05 
Continued from $0062 

Minimum steps required to accel. 
Indirect for NMI-$EB22 


NMI in progress flag 

Auto drive initialization flag 
Sector increment for sequential 
Error recovery counter 

User jump table pointer-SFFEA 
Continued from $006B 

Bit map pointer 

Continued from $006D 

Temporary work space 

Temporary work space 

Temporary work space 

Temporary work space 
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HEX LABEL 
$0073 T4 
$0074 
$0075 IP 
$0076 


$0077 LSNADR 
$0078 TLKADR 
$0079 LSNACT 
$007A  TLKACT 
$007B ADRSED 
$007C ATNPND 
$007D ATNMOD 
$007E PRGTRK 
$007F DRVNUM 
$0080 TRACK 

$0081 SECTOR 
$0082 LINDX 


$0083 SA 
$0084 ORGSA 
$0085 DATA 
$0086 RO 
$0087 =R1 
$0088 R2 
$0089 = R3 
$O08A R4 


$008B RESULT 
$008C 

$008D 

$008E 

$008F ACCUM 

$0090 

$0091 

$0092 

$0093 

$0094 DIRBUF 


$0096 ICMD 
$0097 MYPA 
$0098 CONT 
$0099 BUFTAB 


a a 


FUNCTION 


Temporary work space 
Temporary work space 
Indirect pointer variable 


Listen address: device # + $20 
Talker address: device # + $40 
Active listener flag 

Active talker flag 

Addressed flag 

Attention pending flag 

6502 in attention mode 

Last program accessed 

Current drive number 

Current track number 

Current sector number 

Logical index 

Current secondary address 
Original secondary address 
Temporary data byte 

Temporary work area 

Temporary work area 

Temporary work area 

Temporary work area 

Temporary work area 

Result of multiply/divide rtns 
Result location 

Result location 

Result location 

Remainder of multiply/divide rtns 
Accumulator 

Accumulator 

Accumulator 

Accumulator 

Pointer to directory buffer 
Continued from $0094 

IEEE command in:un-used 

MY PA flag: UN-USED 

Serial bit counter 

Buffer byte pointer:buffer 0 low 
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HEX LABEL FUNCTION 

AEE EE EST ET ET EE ELLE STE TTT E TE I TEE TTT EE a EE 
$009A :buffer 0 high 
$0098 sbuffer 1 low 
$009C :buffer 0 high 
$009D :buffer 2 low 
$009E :buffer 0 high 
$O09F sbuffer 3 low 
$00A0 tbuffer 0 high 
$00A1 sbuffer 4 low 
$00A2 :buffer 0 high 
$00A3 :CMD buffer low 
$O0A4 :CMD buf. high 
$00A5 terror buf. low 
SO0A6 serror buf. high 

’ $00A7 BUFO Inactive flags for buffers 
$00A8 Cont.: inactive flags for buffers 
$00A9 Cont.: inactive flags for buffers 
SOOAA Cont.: inactive flags for buffers 
$O0AB Cont.: inactive flags for buffers 
$Q0AC Cont.: inactive flags for buffers 
$Q0AD Cont.: inactive flags for buffers 
SOOAE BUFI Active flags for buffers 
SOOAF Cont.: active flags for buffers 
$00B0 Cont.: active flags for buffers 
$00B1 Cont.: active flags for buffers 
$00B2 Cont.: active flags for buffers 
$00B3 Cont.: active flags for buffers 
$00B4 Cont.: active flags for buffers 
$00B5 RECL Low record # find Relative file 
$00B6 Cont.: low record # find REL file 
$00B7 Cont.: low record # find REL file 
$00B8 Cont.: low record # find REL file 
$00B9 Cont.: low record # find REL file 
SOOBA Cont.: low record # find REL file 
$00BB RECH High record # to find REL file 
$00BC Cont.: high rec. # find REL file 
$00BD Cont.: high rec. # find REL file 
SOOBE Cont.: high rec. # find REL file 
SOOBF Cont.: high rec. # find REL file 
$00C0 Cont.: high rec. # find REL file 
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$00C1 
$00C2 
$00C3 
$00C4 
$00C5 
$00C6 
$00C7 
$00C8 
$00C9 
$00CA 
$00CB 
$00cc 
$00CD 
SOOCE 
$OOCF 
$00D0 
$00D1 
$00D2 
$00D3 
$00D4 
$00D5 
$00D6 
$00D7 
$00D8 
$00D9 
$OODA 
$00DB 
$00DC 
$O00DD 
$00DE 
$OODF 
$O0E0 
$O0E1 
$00E2 
SO00E3 
$00E4 
SO0E5 
SO0E6 
$00E7 
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LABEL 


NR 


F1PTR 
RECTR 
SSNUM 
SSIND 
RELPTR 
ENTSEC 


ENTIND 


FILDRV 


PATTYP 


FUNCTION 


Next record 
Cont.: next 
Cont.: next 


table 
record table 
record table 


Cont.: next record table 

Cont.: next record table 

Cont.: next record table 

Relative record size table 

Cont.: relative record size table 
Cont.: relative record size table 
Cont.: relative record size table 
Cont.: relative record size table 
Cont.: relative record size table 
Side sector table 

Cont.: side sector table 

Cont.: side sector table 

Cont.: side sector table 

Cont.: side sector table 

Cont.: side sector table 

File stream 1 pointer 

Ist byte wanted from REL record 
Side sector number of REL file 
Index to side sector 

Ptr/lst byte wanted in REL file 
Sector of directory entries 
Cont.: sector of dir. entries 
Cont.: sector of dir. entries 
Cont.: sector of dir. entries 
Cont.: sector of dir. entries 
Index of directory entries 

Cont.: index of directory entries 
Cont.: index of directory entries 
Cont.: index of directory entries 
Cont.: index of directory entries 
Default flag, drive number 

Cont.: default flag, drive number 
Cont.: default flag, drive number 
Cont.: default flag, drive number 
Cont.: default flag, drive number 
Pattern, renew,closed-flags, type 
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TT 


SOOE8 
SO0E9 
SOOEA 
SOOEB 
SOO0EC 
SO0ED 
SO0EE 
SOOEF 
$00FO 
$O00F1 
$00F2 
$O0OF3 
$Oor4 
SOOF5 
$00F6 
SOOF7 
SOOF8 
$OOF9 
SOOFA 
$OOFB 
SOOFC 
SOOFD 
SOOFE 
SOOFF 
$0100 
$0101 
$0102 
$0103 


Oa 


$0200- 
$0229 
$022A 
$022B- 
$202D 
$023E- 
$0243 
$0244- 
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LABEL 


FILTYP 


CHNRDY 


EOIFLG 
JOBNUM 
LRUTBL 


NODRV 
DSKVER 


Z2PEND 


CMDBUF 


CMDNUM 
LINTAB 


CHNDAT 


LSTCHR 


FUNCTION 


Cont.: pat.,renew,c 
Cont.: pat.,renew,c 
Cont.: pat.,renew,c 
Cont.: pat.,renew,c 
Channel file type 
Cont.: channel file 
Cont.: channel file 
Cont.: channel file 
Cont.: channel file 
Cont.: channel file 
Channel status 
Continued: channel 
Continued: channel 
Continued: channel 
Continued: channel 
Continued: channel 
Temporary EOI 
Current job number 


lose-flag, type 
lose-flag, type 
lose-£flag, type 
lose-flag, type 


type 
type 
type 
type 
type 


status 
status 
status 
status 
status 


Least recently used buffer table 


Cont.:least recent 
Cont.:least recent 
Cont.:least recent 
Cont.:least recent 


used buf. tab. 
used buf. tab. 
used buf. tab. 
used buf. tab. 


No drive flag: drive 0 
drive 1, un-used 


DOS version from 18 
Cont.: DOS version 
Un-used 

STACK AREA $0104-S01FF 
Command buffer 


Command number 
Secondary address: 


Channel data byte 


0 
from 18,0 


index table 


Channel last character ptr. 
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| 
HEX LABEL FUNCTION 
ma $0249 
| $024A TYPE Active file type 
$024B STRSIZ String size in command buffer 
a $024C  TEMPSA Temporary secondary address 
: $024D CMD Temporary job command 
: $024E LSTSEC Last sector 
$024F BUFUSE Buffer allocation 
a $0251 MDIRTY Bam dirty flag:drives 0 and 1 
Ld $0252 Cont.: bam dirty flag 
$0253 ENTFND Directory entry found flag 
mq $0254 DIRLST Directory listing flag 
$0255 CMDWAT Command waiting flag 
7 $0256  LINUSE Logical index (lindx) use word 
— $0257  LBUSED Last buffer used 
$0258 REC Record size 
ie $0259 TRKSS Track of side sector 
$025A  SECSS Sector of side sector 
r $025B LSTJOB Last job 
J $025C Continued: last job 
$025D Continued: last job 
ama) $025E Continued: last job 
i | $025F Continued: last job 
i $0260 DSEC Sector of directory entry 
$0261 Cont.: sector of directory entry 
Ij $0262 Cont.: sector of directory entry 
oo $0263 Cont.: sector of directory entry 
$0264 Cont.: sector of directory entry 
$0265 Cont.: sector of directory entry 
hl $0266 DIND Index of directory entry 
$0267 Cont.: index of directory entry 
an $0268 Cont.: index of directory entry 
| $0269 Cont.: index of directory entry 
a $026A Cont.: index of directory entry 
am $026B Cont.: index of directory entry 


$026C ERWORD Error word for recovery 

Lg $026D ERLED Error led mask for flashing 
$026E PRGDRV Last program drive 

an $026F §PRGSEC Last program sector 

$0270 WLINDX Write logical index 
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HEX 


$0271 
$0272 
$0273 
$0274 
$0275 
$0276 
$0277 
$0278 
$0279 


$027A 
$027B 
$027C 
$027D 
$027E 
$027F 
$0280 
$0281 
$0282 
$0283 
$0284 
$0285 
$0286 
$0287 
$0288 
$0289 
$028A 
$028B 
$028C 
$028D 
$028E 
$028F 
$0290 
$0291 
$0292 
$0293 
$0294 
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LABEL 


RLINDX 
NBTEMP 


CMDSI2 
CHAR 
LIMIT 
FICNT 
F2CNT 
F2PTR 


FUNCTION 


Read logical file 
Number blocks temporary 


Cont.: number blocks temporary 


Command string size 
Character under parser 
Pointer limit in compare 
File stream 1 count 

File stream 2 count 

File stream 2 pointer 


PARSER TABLES $027A-$0289 


F1LTBL 


F1LTRK 


F1ILSEC 


PATFLG 
IMAGE 

DRVCNT 
DRVFLG 
LSTDRV 
FOUND 

DIRSEC 
DELSEC 
DELIND 
LSTBUF 
INDEX 


Filename pointer 


Continued: filename pointer 
Continued: filename pointer 
Continued: filename pointer 
Continued: filename pointer 
Continued: filename pointer 


lst file link (track) 
Continued: lst file link 
Continued: ist file link 
Continued: Ist file link 
Continued: lst file link 
lst file link (sector) 
Continued: lst file link 
Continued: lst file link 
Continued: lst file link 
Continued: Ist file link 
Pattern presence flag 
File stream image 

Number of drive searches 
Drive search flag 

Last drive without error 


(track) 
(track) 
(track) 
(track) 


(sector) 
(sector) 
(sector ) 
(sector) 


Found flag in directory searches 


Directory sector 


Sector of Ist available entry 
Index of lst available entry 


=0 if last block 
Current index in buffer 
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~ HEX LABEL FUNCTION 

$0295  FILCNT Counter of file entries 

$0296 TYPFLG Match by type flag: 

$0297 MODE Active mode (r,w) 

$0298 JOBRIN Job return flag 

$0299  EPTR Pointer for recovery 

$029A TOFF Total track offset 

$029B UBAM Last bam update pointer 

$029C Cont.: last bam update pointer 
$029D TBAM Track number of bam image 

$029E Cont.: track number of bam image 
$02Al1- BAM BAM images 

$02B0 Continued: BAM images 

OUTPUT BUFFERS $02B1-$02F8 

masini a ee 
$02B1- NAMBUF Directory buffer 

$02D4 

$02D5- ERRBUF Error message buffer 

$02F8 

$02F9 WBAM Don't write bam flag 

$02FA NDBL Blocks free low byte, drive 0 & 1 
$02FB Cont.: block free low byte 

$02FC  NDBH Blocks free high byte,drive 0 & 1 
$02FD Cont.: blocks free high byte 
$02FE PHASE Phase offset 

$02FF Continued: phase offset 

DATA BUFFERS $0300-S06FF 

$0300- BUFFO Buffer #0. 

$O3FF Continued: Buffer #0 

$0400- BUFF1 Buffer #1 

SO4FF Continued: Buffer #1 

$0500- BUFF2 Buffer #2 

SOSFF Continued: Buffer #2 

$0600- BUFF3 Buffer #3 

SO6FF Continued: Buffer #3 


$0620 


CNT 


Error counter: decrements from 10 
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HEX LABEL FUNCTION 

$0620 FMTVAR Format variable 

$0621 NUM Number between sync & non-sync 
$0623 TRYS Number of tries in verify 
$0624  TRAL 

$0625 

$0626 DTRCK Distance to track 

$0627  REMDR Remainder of size 

$0628 SECT Sector number counter 


SERIAL I/O 6522 $1800-$180F 


Data port b 

Data port a: UN-USED 

Data direction register port b 
Data direction register port a 
Timer 1 low count 


Timer 1 high counter 
Timer 1 counter 
Timer 1 low latch 
Timer 1 high latch 
Timer 2 low counter 
Timer 2 high counter 


Shift register 

Auxillary control register 
Peripheral control register 
Interrupt flag register 
Interrupt enable register 


DISK CONTROLLER 6522 $1C00-$1COF 


-$1C00 


DSKCNT 


Disk controller I/0 control line 
bit 0: step head in 


bit 1: step head out 

bit 2: motor on (1), off (0) 
bit 3: drive active LED on/off 
bit 4: write protect sense 

bit 5: density select 0 

bit 6: density select 1 

bit 7: sync detect 
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HEX LABEL FUNCTION 

$1C01 DATA2 Data port a 

$1002 DDRB2 Data direction for port b 
$1C03  DDRA2 Data direction for port a 
$1004 TILC2 Timer 1 low counter 

$1C05 TI1HC2 Timer 1 high counter 
$1006 TI1LL2 Timer 1 low counter 

$1007 T1HL2 Timer 1 high counter 


$1€08 T2LL2 Timer 2 low counter 
$1C09 T2LH2 Timer 2 high counter 


$1COA SR2 Shift register 

$1COB ACR2 Auxillary control register 
$1COC PCR2 Peripheral control register 
$1COD 1FR2 Interrupt flag register 
$1COE 1ER2 Interrupt enable register 
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1571 Specifications 
MFM Format 
GCR Format 
1571 Diskette Format 
1571 Sector Distribution 
1571 BAM 
1571 Directory Header 
DOS Shell 

Language Choice 

40 OR 80 Column 

Main Menu 

Disk/Printer Setup 

Run a Program 

Format a Disk 

Cleanup a Disk 

Copy a Disk 

Copy Files 

Delete Files 

Restore Files 

Rename Files 

Reorder Directory 
1571 File Types 
1571 File Formats 

PRG File Format 

SEQ File Format 

REL File Format 

REL Side Sector Format 
File Commands 

SEQ File Commands 

REL File Commands 
Internal Disk Commands 
Direct Access Commands 
Related Kernal Routines 
Error Checking 
Memory Locations 
Change Device Number 
BASIC 7.0 Disk Commands 
1571 DOS Error Messages 
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1571 SPECIFICATIONS 





SINGLE DOUBLE 
SIDED SIDED 


Drives per unit 1 1 
Heads per drive 2 2 


FORMATTED STORAGE 


Capacity per unit 170 K 341 K 
Max # files per diskette 144 144 

Max # SEQ file size 164 K 329 K 
Max # REL file size 163 K . 163 K 


DISK FORMAT 


Tracks 35 70 
Sectors per track 17-21 17-21 
Bytes per sector 256 256 
Blocks free per unit 664 1328 
PHYSICAL DIMENSIONS ELECTRICAL 

Height (inches) 3 Power (watts) 35 

Width (inches) 7 Voltage 110-120 
Depth (inches) 13 VAC. 60 hz. 


Weight (pounds) 10 
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The 1571 disk drive, can record data in two different 
formats, MFM and GCR. The MFM format, is double den- 
sity, this allows access to CPM software libraries of 
other computers. The GCR format, is used in both the 
C-128 and C-64 modes. 


MFM FORMAT 





Total unformatted capacity 250000 bytes per side 
Total formatted capacity 
Sector size 128 133120 bytes per side 
Sector size 256 163840 bytes per side 
Sector size 512 184320 bytes per side 
Sector size 1024 204800 bytes per side 
Maximum tracks per side 40 x 2 sides 
Sectors per track 
Sector size 128 26 
Sector size 256 16 
Sector size 512 9 
Sector size 1024 5 





1571 GCR FORMAT 








SINGLE DOUBLE 
SIDED SIDED 
Unformatted capacity 252019 bytes 252019*2 bytes 
Formatted capacity 174848 bytes 349696 bytes 
Max SEQ file size 168656 bytes 337312 bytes 
Max REL file size 167132 bytes 167132 bytes 
Records per file 65535 65535 
Max files per disk 144 144 
Tracks per disk 35 70 
Max sectors per track 17-21 17-21 
Max Sectors per disk 683 1366 
Reserved sectors 19 38 
Available sectors 664 1328 
Max bytes per sector 256 256 


aE 
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1571 DISKETTE FORMAT 


The diskettes you purchase are totally blank. This is 
so they are generic to many types of disk drive. Each 
buyer must format new disks for their own disk unit. 
The command to format a diskette is called the HEADER 
command. As the format process takes place, the disk- 
ette is divided into tracks and made ready to receive 
information. A directory (DIR) and Block Availability 
Map (BAM) are created on track 18 of the diskette. A 
directory is much like an index or table of contents 
of a book. Everytime a file is added to the disk, it 
is recorded in the directory. When a disk is accessed 
the drive looks at the DIR as a road map to find it's 
way around the diskette. The BAM is another kind of 
map of the diskette. It shows blocks that have been 
used, and ones that are vacant. 


The command to format a diskette is as follows: 
C-128 mode: 
HEADER"diskette name"Iid,Ddrive#[,Udevice#] 


The diskette name is your choice, up to 16 character 
spaces. The ID can be any two characters, so long as 
they do not form a key-word. It is best, that all of 
your ID's be different, so as to not confuse the disk 
drive. If you were to attempt to move a file from one 
disk to another, and both had the same ID's, the disk 
drive would not know where the file should go. 


The following charts show the layout of the diskette 
after the format command has taken place. Track one 
is on the outter edge of the disk and track 35 at the 
center. The back side of a double sided diskette, is 
a continuation of the front (tracks 35 to 70). 
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SINGLE | DOUBLE 
SIDED | SIDED 


Number of tracks per diskette 
Number of blocks per diskette 
Number of blocks reserved (BAM/DIR) 
Number of blocks available to user 











eheough: 2 
through 
through 
through 
through 
through 
through 
through 


0 
0 
0 
0 
0 
0 
0 
0 
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1571 BAM 
( Block Availability Map, Track 18,Sector 0) 


| BYTES | CONTENTS DEFINITION 


18 
01 
65 


Track 53, Sector oO 


0 - 104 BAM for tracks 36 thru 70. 
105 - 255 Unused 


1571 DIRECTORY HEADER 


| Byres | CONTENTS ACTION 


144-159 Diskette name padded with 
shifted spaces. 





Pointer to the track of 
the next directory entry. 
Pointer to the sector of 
the next directory entry. 
ASCII character A indicat 
ing 1541 format. 

Flag, double-sided disk 
$80 = Double-sided, 

$00 = Single-sided. 

Block Availability Map 
Block Availability Map 
Usable SECTORS TRACK 53=0 
SECTORS ARE PRE-ALLOCATED. 
Block Availability map 




















4 - 143 
221 - 237 
238 


239 - 255 


160-161 Shifted spaces. 
162-163 Diskette ID 
164 Shifted space. 
165-166 DOS version/format type. 
167-170 Shifted spaces. 
171-220 Unused. 
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DOS SHELL 


The program DOS shell can be found on the disk titled 
'TEST/DEMO DISKETTE' that was provided with the 1571. 
The shell provides a substitute method for entree of 
disk drive commands. To load the DOS shell; insert 
the diskette while the computer is turned off. When 
the computer is switched on ( or reset ), the program 
will automatically load and run. To enter or exit the 
DOS shell, press the Fl key. The file is menu driven 
for quick identification of operations. 





LANGUAGE CHOICE 

All information may be displayed in one of four lang- 
uages: English, French, German, and Italian. To adopt 
a preference, press the SPACE BAR as the one you want 
appears or wait until the next is shown. 


40 OR 80 COLUMN MODE 

The shell may be used in either 40 or 80 column mode. 
The choice must be made before a selection is made 
from the main menu. 


MAIN MENU 

To make a selection from the menu, use the CRSR key 
to move the cursor up or down to the wanted function. 
Then press the SPACE BAR to activate the operation. 


DISK/PRINTER SETUP 

There are two logical drives ( A and B ), that live 
within the shell. They may be set to represent a sin- 
gle disk drive, two individual drive units, or a duel 
drive. 


EXAMPLE: If you have one disk drive the setting would 
be A = device #8 and B = drive #0. These are the set- 
tings when you enter the shell. If you have a single 
drive unit, everything is ready to go. When using two 
single drives, or a dual drive, the device number of 
one unit must be changed. 
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(eet, Slee, “Ere, 


To make the desired changes, move the cursor over the 
proper choice, then depress the SPACE BAR. Next press 
F7 to lock in a setting. The F7 key will cancel your 
choice, if you should change your mind. The printer 
device #'s may also be changed in the same manner. 


CRSR keys To choose a program 

SPACE BAR To lock in choice 

F5 To un-select a program 

F7 To load and.run choosen file 
STOP key To cancel function 

F3 To print out file list 


FORMAT A DISK 





Place the diskette to be formatted in the disk drive. 
Next press the SPACE BAR. The shell will check to see 
the disk is blank or contains files you might wish to 
save. I£ everything is the way you intend, enter the 
new disk name and press RETURN. The shell generates a 
new disk ID, or you may enter one, by adding a coma, 
plus a two digit number after the name of the disk. 


CLEANUP A DISK 





The ‘CLEANUP A DISK' command, is the same as the VAL- 
IDATE function. The Block Availability Map ( BAM ) is 
recalculated, counting only closed files or programs. 
All un-used sectors, or improperly closed files, are 
made ready for use. 


It is good practice to use this function when a disk- 
ette has had many alterations or many files have been 
scratched. Often the blocks free shown will increase. 
increase. 
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COPY A DISK 





This function, is for making a entire copy of a disk. 
All files will be moved from the old disk, to the new 


one. 
DUAL DRIVE 

LL ES SE TTL a TT aD ETE 

CRSR keys To choose from which drive to 
copy from/to 

SPACE BAR To lock in choice of drives 

STOP key To cancel function 

SPACE BAR or F5 To re-enter, if an error is 
made 


SINGLE DRIVE 


WHEN THIS FUNCTION IS USED, ALL FILES IN MEMORY WILL 
BE LOST. Press the STOP or F5 key cancel or the SPACE 
BAR to continue. The copy is made by swaping disks in 
the drive, from one to four times, as prompted by the 
computer. The new disk is automatically formatted and 
a new ID assigned. To fall back to the previous disk 
swap, press either the SPACE BAR or F5. The STOP key 
will cancel the copy function completely. ; 





0 
fe) 
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This mode enables the user to move single files from 
one disk to another. If the destination diskette is 
not formatted, you may do so during this process. The 
shell automatically checks to see, if there is space 
for the new file on your diskette. You will be warned 
if there are not enough blocks free. 


CRSR keys To choose a file 

SPACE BAR To lock in choice of file 
F5 To un-select a file 

F7 To continue function 
STOP key To cancel function 


- 181 - 


«-- 1571 MODE YELLOW --)> 





DELETE FILES 





CRSR keys To choose a file 

SPACE BAR To lock in choice 

F7 Double check by the computer 
answer ‘Y' or 'N' 

F5 To restart file selection 

STOP To cancel function 





RESTORE FILES 





This function can be used to restore files. 





CRSR keys To choose a file or file type 
SPACE BAR To lock in choice of file 

F5 To un-select a file 

F7 To continue function 


Css. ies 


RENAME FILES 





This function allows the user to rename files. 





CRSR keys To choose a file to rename 
SPACE BAR To lock in choice of file 
F5 To return to file selection 
F7 To complete rename function 








CRSR keys To choose a file or move 

SPACE BAR To lock in choice of file or 
lock in move 

F7 To end file selection 

F5 To restart file selection 
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1 FILE TYPES 


different types of files that may 

k. Each appears in the directory by 
If you go a bit further and examine 
location map, track 18, sector 1 ), 
s the file type in hexadecimal. 


FILE TYPE DIRECTORY APPEARS | HEX | ASCII 


Scratched 

Deleted (DEL) 
Sequential (SEQ) 
Program (PRG) 
User (USR) 
Relative (REL) 
Open DEL 

Open SEQ 

Open PRG 

Open USR 

Open REL 

DEL @ replacement 
SEQ @ replacement 
PRG @ replacement 
USR @ replacement 
REL @ replacement 
Locked DEL 

Locked SEQ 

Locked PRG 

Locked USR 
Locked REL 


not shown 


not shown 
*SEQ 
*PRG 
*USR 
not apply 
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1571 FILE FORMATS 


The three primary types of files stored upon disk are 
PROGRAM (PRG), SEQUENTIAL (SEQ), and RELATIVE (REL). 
The PRG format is generally used for programs that do 
not store user input to the disk. The SEQ file is an 
efficient method of information storage. This type of 
files are refered to as sequential, because pieces of 
information are stored in them one after another. The 
typical REL file is well suited for extensive amounts 
of information and allows for fast access of data. As 
they all handle data in a different manner, the disk 
format must also be unique to the type of file. 


rr 


PROGRAM (PRG) FILE FORMAT 


DEFINITION 


SECTOR 1 

0,1 Track and sector of next block in file 1. 
2,3 Load address of the program 

4-255 Program information as in memory. 


REMAINING SECTORS 
0,1 Track and sector of next block in file 1. 
2-255 Program information as in memory. 


LAST SECTOR 
Null-followed by # of data bytes in sector 
Last bytes of information as in memory. 
End of file is marked by 3 zero bytes. 


SEQUENTIAL (SEQ) FILE FORMAT 
DEFINITION 


ALL EXCEPT LAST SECTOR 


0,1 Track and sector of next SEQ data block. 
2-255 254 bytes of data. 
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LAST SECTOR 


0,1 
2-2? 


Null-followed by # of data bytes in sector 
Last bytes of data. any other bytes are 
garbage. 


RELATIVE (REL) FILE FORMAT 


DEFINITION 


Track and sector of next data block. 
254 bytes of data. The first byte of an 
unused record contains $FF followed by 


$00 to the end of record. Partial records 
are completed with zeros. 


SIDE SECTOR BLOCK 


0,1 
2 
3 
4-5 


8-9 
10-11 
12-13 
14-15 
16-255 


Track and sector of next side sector block 
Side sector number (0-5). 

Record length. 

Track & sector of first (#0) side sector. 
Track & sector of second (#1) side sector. 
Track & sector of third (#2) side sector. 
Track & sector of fourth (#3) side sector. 
Track & sector of fifth (#4) side sector. 
Track & sector of sixth (#5) side sector. 
Track & sector pointers to 120 data blocks 





Same ho Mid 


«-- 1571 MODE YELLOW --> 


FILE COMMANDS 


Data files store information to be used by a program. 
SEQuential or RELative files, save the information to 
a diskette. Both are generic in that they may be read 
by many different programs. For an example, data that 
is saved by a word processor, may be stored, as a SEQ 
file and read by several brands of program. 


SEQ files are more efficient in the use of disk space 
than REL files. Data stored in SEQ files is stored in 
order recieved, one after the other. Where as, with a 
REL file, you can tell the disk drive, where to place 
the information. To retreive stored information, the 
entire SEQ file must be moved into memory. Access to 
a single record, within a file is possible with a REL 
file. The pros and cons go on, choice is dependent on 
the intended use. 


The commands below, are used to create SEQ, and REL 
files. 





SEQ FILE COMMANDS 





APPEND 350 OPEN#1,8,1,"data file,s,a" 
Open a SEQ file for appending to. 


GET# 385 GET#1,a$ 
Used to read 1 byte from SEQ file set up for read. 


INPUT# 390 INPUT#1,a$ 
Used to read 1 record from SEQ file set up for read. 


M mode 395 openl,8,2,"data 1,s,M" 
Enables recovery of data from open SEQ file. 


PRINT# 380 PRINT#1,a$ 
Writes to already open SEQ file set for write. 
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READ 360 open#1,8,1,"data file,s,R" 
Open a SEQ file for reading. 


WRITE 370 open#1,8,1,"date file,s,W" 
Open a SEQ file for writing. 





REL FILE COMMANDS 





DOPEN 350 DOPEN#1,"data",1{record len],D0,U8 
Open a REL file or create one. 


GET# 370 GET#1,a$ 
Used to read 1 byte from a REL file. 


INPU T# 375 INPUT#1,a$ 
Used to read 1 record from a REL file. 


PRINT# 400 PRINT#1,a$ 
Used to write to an opened REL file. 


RECORD 360 RECORD#1, 20,0:RECORD#1, 20,0 
Positions the drive at RECORD #20. Note: the RECORD 
command should be used twice 
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INTERNAL DISK COMMANDS 





BLOCK—EXECUTE $420 print#15,"B-E";3;18;0 
This rarely used command allows loading of a sector 
into disk memory and execution of it. 


MEMORY—-EXECUTE 410 print#15,"M-E" 

chr$(L add)chr$(H add) 
Allows execution of any routine in disk memory, RAM 
or ROM. L = low memory add., H = high memory add. 


MEMORY—READ 390 print#15,"M-R" 

chr$(L add)chr$(H add) (chr$(bytes) ] 

Allows you to select which byte or bytes to read in 
from disk memory. 


MEMORY—-WRITE 400 PRINT#15, "M-W" 

chr$(L add)chr$(H add) 
Allows you to write up to 34 bytes at a time into 
disk memory. 











User Commands Function 
uo Restores default user jump table. 
Ul or UA Block read replacement. 
U2 or UB Block write replacement. 
U3 or UC Jump to $0500. 
U4 or UD Jump to $0503. 
US or UE Jump to $0506. 
UG or UF Jump to $0509. 
U7 or UG Jump to $050C. 
US or UH Jump to $050F. 
US or UL Jump to ($FFFA) reset tables. 
U:z: or UT Power up vector. 
EXAMPLE : 430 print#15, "Ucharacter"; 
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DIRECT ACCESS COMMANDS 


The DIRECT ACCESS commands read or write data to spe- 
cific sectors. These commands are entirely controlled 
by the user. These are excellent when used in utility 
programs to view or alter locations on a diskette. 





BLOCK—ALLOCATE 390 print#15,"B-A";0;1;1 
Marks a sector as used. 


BLOCK—_-FREE 400 print#15,"B-F";0;1;1 
Used to free a sector. 


BLOCK—-READ 360 print#15, "B-R";2;0;10;12 
Moves 1 block of data into selected buffer. 


BLOCK—-WRITE 370 print#15,"B-W";2;0;10;12 
Writes 1 block of data to the selected disk sector. 


BUFFER—POINTER = 380 print#15,"B-P";2;1 
Points to where next READ/WRITE begin in disk buffer 


OPEN# 350 OPEN#2,8,2, "#" 
Open a channel and assign any buffer. 


U1 360 print#15,"U1";2;0;10;12 
Moves 1 block of data into selected buffer. More 
reliable then the 'BLOCK-READ' command. 


U2 370 print#15,"U2";2;0;10;12 
Writes 1 block of data to the selected disk sector. 
More reliable then the 'BLOCK-WRITE' command. 


FE a] 
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RELATED KERNAL SUBROUTINES 


The following list of subroutines are from the kernal 
ROM of the C-128. These may be of useful when writing 
programs that interact with the disk drive. 





ADDRESS LABEL FUNCTION 





SFFBA SETLFS Set logical,first & second add. 

SFFBD SETNAM Set length & address of filename 

SFFCO OPEN Open a logical file 

SFFC3 CLOSE Close a logical file 

SFFC6  CHKIN Select a channel for input 

SFFC9 CHKOUT Select a channel for output 

SFFCC CLRCHN Clear all channels & restore 
default 1/0 

SFFCF  CHRIN Get byte from current input device 

SFFD2 CHROUT Output a byte to current output 
device 





ERROR CHECKING 


ee 


When a disk error happens, the light on the front of 
the disk drive will flash green. To identify the pro- 
blem, type the following: 


PRINT DS$ 


An error message will be displayed to the screen, the 
error will be cleared from disk memory. This command 
may be used to read the error channel at any time. 


PRINT DS 


DS (Disk Status numeric value only) The value return- 
ed will be zero if the last disk access was OK. 


mL ON = 
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MEMORY LOCATIONS 





The following are memory locations from the 1571. 





Q0000-OOFF # Zero page work area, job que, variables 

0100-01FF GCR overflow area/stack (1571 mode BAM 
side one) 

0200-02FF Command buffer, parser, tables, variables 

0300-07FF 5 data buffers, 0-4, one is used for BAM 

1800-65C22A Serial, controller ports 

1€00-65C22A Controller ports 

8000-FFE5 32K byte ROM, DOS/controller routines 

FFEG-FFFF  JMP table, user command vectors 





CHANGE DEVICE NUMBER 





HARDWARE CHANGE 





On the back of the 1571 disk drive, are two switches. 
Below is a chart that shows the different settings to 
change the device number of the drive. 


LEFT RIGHT DEVICE # 


UP UP 
DOWN UP 
UP DOWN 
DOWN DOWN 





SOFTWARE CHANGE 
ES A ASS ID IE I TET TT EF ETE, BS EP ITS TT ET I PI 


To make a temporary change of device number, type the 
following: 


PRINT#15,"U0>" + CHRS$(n) 
The letter may be a number from 8 to 30.The change is 
effective until changed again or the 1571 is reset. 


EER IEP IR SPE MEW A, EE SE I ENT TEE REET 
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BASIC 7.0 DISK COMMANDS 


The commands listed below are used with the 1571 disk 
Grive in C-128 mode. 





COMMAND 


USE 


SLL EE I APS EE 


APPEND 
BLOAD 


BOOT 
BSAVE 


CATALOG 
CMD 
COLLECT 
CONCAT 
COPY 
DCLEAR 
DCLOSE 
DIRECTORY 
DLOAD 
DOPEN 
DSAVE 
DVERIFY 
GET# 
HEADER 
INITIALIZE 
INPUT# 
PRINT# 
RECORD 
RENAME 
RUN 
SCRATCH 
VERIFY 


Append data to file 

Load a binary file starting at 
specific memory location 

Load and execute program 

Save a binary file to a specified 
memory location 

Display contents of dir. on monitor 
Redirect screen output to disk file 
Free inaccessible disk space 
Concatenate two data files 

Copy files between devices 

Clear open channels on disk drives 
Close logical disk file 

Display contents of dir. on monitor 
Load a BASIC program from disk 
Open disk file for read/write 

Save a BASIC program to disk 
Compare file in mem to file on disk 
Read one byte from a record 

To format a disk, make ready to use 
Returns drive to power-up condition 
Read whole record from disk 

Output data to a file 

Position REL file pointers 

Change name of a file on disk 
Execute BASIC program from disk 
Erase file(s) from a disk 

Compare file in mem to one on disk 


Age = 
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joy 
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1571 DOS ERROR MESSAGES 


Errors are evaluated by the DOS when encountered dur- 
ing a read or write function. The error messages that 
follow, may be generated if an error is found. Don't 
panic, evaluate the situation carefully. Some errors 
may also be caused by equipment failure. Check cable 
connections and be sure the system is grounded. 


ERROR # MESSAGE and EFFECT 
CL SA I I PEAS SRSA EP SSA BG ET EW EE ARSE 

0 Everything is OK, no error exists 

1 This is not an error, denotes file scratched 

2-19 Unused error messages, ignore 

20 READ ERROR, block header of requested block 
not found. Cause, either illegal block number 
or destroyed header. 

21 READ ERROR, sync mark missing. Cause, read- 
write head out of alignment, no disk in drive, 
disk not formatted. 

22 READ ERROR, data failed to match against a 
preset data block identifier. 

23 READ ERROR, checksum error in data block did 
not match checksum read from the disk. 

24 READ ERROR, byte decoding error. Hardware 
error created due to bad bit pattern in the 
data byte. 

25 WRITE ERROR, write verify error. There is a 
mismatch between data just written and data 
in RAM when compared. 

26 WRITE PROTECT ON, a write protect tab is over 
the notch in the side of the disk. Remove to 
write to the disk. 

27 READ ERROR, checksum error in header. There 

is an error in the header of the requested 
data block. 

28 WRITE ERROR, long data block. A sync mark has 
not been found, cause bad format. 

29 DISK ID MISMATCH, a comparison of ID ina 
header block has been made, it does not match 
the master copy of the disk ID. 
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SS SI PT TE I LE EE ST 


ERROR 


MESSAGE and EFFECT 


ene 


SYNTAX ERROR, the DOS cannot understand the 
command sent to the command channel. 

SYNTAX ERROR, the DOS cannot recognize the 
command. Command must begin in the first space 
SYNTAX ERROR, invalid command. A command has 
been sent that is longer than the allowable 

58 characters. 

SYNTAX ERROR, invalid file name. Pattern 
matching may not be used with the OPEN or SAVE 
command. 

SYNTAX ERROR, no file given. The file name has 
been left out of the command. 

SYNTAX ERROR, invalid command. Command is not 
recognized by the DOS. 

RECORD NOT PRESENT, the disk has been ask by 
an INPUT#, OR GET# to read past the last 
record. 

OVERFLOW IN RECORD, PRINT# statement exceeds 
the defined size. 

FILE TOO LARGE, record position within a REL 
file indicates that disk overflow will result. 
WRITE FILE OPEN, attempt made to open a file 
that is already open. 

FILE NOT OPEN, attempt made to access a file 
that is not open. 

FILE NOT FOUND, the file does not exist on the 
indicated drive. Common cause, in-correct file 
name. 

FILE EXISTS, attempt made to save a file by a 
name that already exists on the disk. 

FILE TYPE MISMATCH, requested file type does 
not match type recorded on the directory. 

NO BLOCK, block has been previously allocated. 
ILLEGAL TRACK AND SECTOR, attempt made to 
access.a track or sector that does not exist 
in the format being used. 

ILLEGAL SYSTEM TRACK OR SECTOR, indicates an 
illegal track or sector. 
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ERROR # MESSAGE and EFFECT 





70 


NO CHANNEL, requested channel is not available 
, Channel may be in use. SEQ files limited to 
three open at a time. Direct access channels 
limited to six. 

DIRECTORY ERROR, BAM (block availability map) 
does not match internal count. 

DISK FULL, all blocks have been used or the- 
directory has reached limit (144 entries). 

DOS MISMATCH, The diskette has been written by 
another DOS. You may read the disk but not 
write to it. 

DRIVE NOT READY, there is no diskette in the 
drive or drive is not on. 
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GENERAL 


ORANGE 


AS SL SR AL I SS TP TI TET 


Numeric Conversion Chart 
Decimal—Hex-Octal-Binary 


ASCII Conversion Chart 
Multiplication Table 
HEX Addition Table 


HEX Multiplication Table 


Super Help Chart 
MCS6510 Instruction Set 
Symbols & Operators 
Screen Format Tables 

80 Column Screen 

40 Column Screen 

25 Row Screen Format 
Standard Abbreviations 
Cassette Commands 


2.797. 
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NUMERIC CONVERSION TABLE 


DECIMAL OCTAL BINARY 
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00000000 
00000001 
00000010 
00000011 
00000100 
00000101 
00000110 
00000111 
00001000 
00001001 
00001010 
00001011 


00001100 


00001101 
00001110 
00001111 
00010000 
00010001 
00010010 
00010011 
00010100 
00010101 
00010110 
00010111 
00011000 
00011001 
00011010 
00011011 
00011100 
00011101 
00011110 
00011111 
00100000 
00100001 
00100010 
00100011 
00100100 
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00100101 
00100110 
00100111 
00101000 
00101001 
00101010 
00101011 
00101100 
00101101 
00101110 
00101111 
00110000 
00110001 
00110010 
00110011 
00110100 
00110101 
00110110 
00110111 
00111000 
00111001 


~00111010 


00111011 
00111100 
00111101 
00111110 
00111111 
01000000 
01000001 
01000010 
01000011 
01000100 
01000101 
01000110 


01000111 


01001000 
01001001 
01001010 
01001011 





DECIMAL 
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OCTAL 
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BINARY 


01001100 
01001101 
01001110 
01001111 
01010000 
01010001 
01010010 
01010011 
01010100 
01010101 
01010110 
01010111 
01011000 
01011001 
01011010 
01011011 
01011100 
01011101 
01011110 
01011111 
01100000 
01100001 
01100010 
01100011 
01100100 
01100101 
01100110 
01100111 
01101000 
01101001 
01101010 
01101011 
01101100 
01101101 
01101110 
01101111 
01110000 
01110001 
01110010 





fs, tee 
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01110011 
01110100 
01110101 
01110110 
01110111 
01111000 
01111001 
01111010 
01111011 
01111100 
01111101 
01111110 
01111111 
10000000 
10000001 
10000010 
10000011 
10000100 
10000101 
10000110 
10000111 
10001000 
10001001 
10001010 
10001011 
10001100 
10001101 
10001110 
10001111 
10010000 
10010001 
10010010 
10010011 
10010100 
10010101 
10010110 
10010111 
10011000 
10011001 
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DECIMAL | HER OCTAL BINARY 
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10011010 
10011011 
10011100 
10011101 
10011110 
10011111 
10100000 
10100001 
10100010 
10100011 
10100100 
10100101 
10100110 
10000111 
10101000 
10101001 
10101010 
10101011 
10101100 
10101101 
10101110 
10101111 
10110000 
10110001 
10110010 
10110011 
10110100 
10110101 
10110110 
10110111 
10111000 
10111001 
10111010 
10111011 
10111100 
10111101 
10111110 
10111111 
11000000 
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11000001 
11000010 
11000011 
11000100 
11000101 
11000110 
11000111 
11001000 
11001001 
11001010 
11001011 
11001100 
11001101 
11001110 
11001111 
11010000 
11010001 
11010010 
11010011 
11010100 
11010101 
11010110 
11010111 
11011000 
11011001 
11011010 
11011011 
11011100 
11011101 
11011110 
11011111 
11100000 
11100001 
11100010 
11100011 
11100100 
11100101 
11100110 
11100111 
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DECIMAL | HEX OCTAL BINARY 
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11101000 
11101001 
11101010 
11101011 
11101100 
11101101 
11101110 
11101111 
11110000 
11110001 
11110010 
11110011 
11110100 
11110101 
11110110 
11110111 
11111000 
11111001 
11111010 
11111011 
11111100 
11111101 
11111110 
11111111 
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ASCII CONVERSION CHART 


EVEN ODD 
PARITY PARITY 


EBC- 
DEC HEX CBM DEC DEC DIC 


0 
1 
2 
3 
4 
5 
6 
7 
8 
oo 
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EVEN ODD 
PARITY PARITY 


1 + een = MR HFM tH 
1’ + £VR WM HM tH 


we ODWMDAIKTO PONDeH ON 


/ 
0 
1 
2 
3 
4 
5 
6 
7 
8 
9 
« 
> 
¢ 
@ 
a 
b 
“Cc 


AWPTrmarwv i aw 





fa Aes 


ee 


Co 


(S23 ‘se, “ieee 


{__J 
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EVEN ODD 
PARITY PARITY 


68 | 44| a 6s | 44 


e 
f 
g 
h 
i 
j 
k 
1 
m 
n 
o 
Pp 
q 
r 
s 
t 
u 
v 
w 
x 
y 
Z 
[ 
x 
] 
* 


memawarms «OHM CAEN KM MEK CHNDO VOSA EWR TA tao 
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EVEN ODD 
PARITY PARITY 


g 
h 
i 
j 
k 
1 
m 
n 
) 
p 
q 
r 
s 
t 
u 
v 
W 
x 
Y 
Z 
* 
* 
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1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
11 
12 
13 
14 


rad } 
nw 


WWMNIAMAM Pon 


MULTIPLICATION TABLE 
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HEX ADDITION TABLE 


fo [123456789 A BCDEP 


WYMmOQWPRrP WO ONMHAU S&S wn 


HEX MULTIPLICATION TABLE 


2 
3 
4 
5 
6 
7 
8 
3 
A 
B 
C 
D 
E 
F 
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SUPER HELP CHART 


EL ES SP ST I I AP TT 
DEC HEX BASIC 6510 ASCII SCREEN 
OPS CODES 


000 OO END BRK @ 
001 O1 ORA($ZZ,X) A a 
002 02 B b 
003 03 stop Cc om 
004 04 D d 
005 05 ORA $22 white E e 
006 06 ALS $22 F £ 
007 07 G g 
008 08 PHP disable SHIFT/CMDR H h 
009 09 ORAS$ii enable SHIFT/CMDR I i 
010 OA ASL J j 
011 OB K k 
012 OC L 1 
013 OD ORAS$nnnn return M m 
014 OE ASLS$nnnn lower case N n 
015 OF (é) ° 
016 10 BPL$nnnn P p 
017 «#11 ORA($zz),¥Y cursor down Q q 
018 12 ReVerSe on R r 
019 #13 CLeaR HONE s s 
020 14 INSerT DELete T t 
021 15 ORAS$zz,X U u 
022 16 ASLS$zz,X V Vv 
023 17 W W 
024 18 LLC X x 
025 19 ORA$nnnn, Y Y y 
026 JA Z Zz 
027 1B [ 

028 iC red £ 

029 1D ORASnnnn,X cursor right J 

030 IE ASL$nnnn,X green 2 

031 IF blue we 

032 20 space JSR$nnnn Space Space 
033 21 !: £AND($zz,X) ! ! 

0 34 2 2 u a a 

035 23 # # # 
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a 2S I a ED 


DEC HEX BASIC 6510 


C= 


1s + ewe nm DK 


WANNDU PWNHHO™>* 


HrUrOo Ws NW Pearvrvili was 6 


OPS CODES 


BITS$zz 
ANDS$2z 
RDL$zz 


PLP 
ANDS$$ii 
ROL 


BiIT$nnnn 
AND$nnnn 
ROLS$Snnnn 


BMI$nn 
AND($zz),¥ 


AND$zz,X 
ROLS$zz,X 


SEC 
ANDS$nnnn, ¥ 


AND$nnnn, X 
ROLSnnnn, X 


RTI 
EOR($zz,X) 


EOR$zz 
LSR$zz 


PHA 
EOR#$ii 


i ee ee 


WANA HPWNErON> 


HDA MMOAW Pea VY IAs» 


un 


SCREEN 
$ 

% 

& 

' 

( 

) 

x 

+ 

/ 

0 0 
1 1 
2 2 
3 3 
4 4 
5 5 
6 6 
7 7 
8 8 
9 9 
« < 
> > 
? ? 
graphic 
a A 
iy B 
tt Cc 
a D 
Ly E 
F 
a G 
" H 
a I 


ez, TES 


cana bes 





fe 








bese; een. NESS 


tees 











ae 
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DEC HEX BASIC 6510 ASCII SCREEN 
OPS CODES 

074 4A J LSR J 7 J 

075 4B XK K " K 

076 #4C jL JMPS$nnnn L a L 

077 4D M  EORSnnnn M tt M 

078 4E j.N_ LSRS$nnnn N a N 

079 4F O ce) ft 0 

080 50 P BVC$nn P " P 

081 51 Q _ EOR($zz),¥ Q if Q 

082 52 R R " R 

083 53 #=§ S 7 Ss 

084 54 T T 7 T 

085 55 U  EOR$zz,X U m U 

086 56 V  LSR#zz,X V . Vv 

087 57 W a 7 W 

088 58 xX CLI X u X 

089 59 YY  EOR$zz,Y Y Ht Y 

090 5A @ 2 q Z 

091 5B a left bracket 

092 5C »b english pound 

093 5D c  EORS$nnnn,X e graphics 

094 5E d_ LSRS$nnnn,X . " " 

095 5F e te " g 

096 60 #j£- RTS graphics space 

097 61 g ADC($zz),X " graphics 

0 98 6 2 h Lu a " 

099 63 i . " 

100 64 j 

101 65 k  ADCS$zz 

102 66 1  RORSzz 

103 67 

104 68 n_ PLA 

105 69 o ADC#S$ii 

106 6A p_ ROR 

107 6B q 

108 6C r  JMP($nnnn) 

109 6D s  ADCS§nnnn 

110 6E ct  RORSnnnn 

111 6F u 
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en anaes 


ASCII 


DEC HEX BASIC 6510 

OPS CODES 
EESTI ESET II ESTE TT IE EIT EOE ELE R DIETS LE IE OE LETTE ILE ELE ATE LT EE ETT, 
112 70 V BVS$nn 
113 71 W ADC($zz),y 
114 72 x 
115 73 y 
116 74 Z 
117 75 ADC$zz,X 
118 76 RDR$zz,X 
119 77 
120 78 SEI 
121 79 ADC$nnnn, Y 
122 7A 
123 7B 
124 7C 
125 7D ADC$nnnn, X 
126 7E ROR$nnnn, X 
127 7F 
128 80 END 
129 81 FOR STA($zz,X) 


132 84 INPUT# STASzz 


133 85 INPUT STASzz 
134 86 DIN STX$zz 
135 87 READ 

136 88 LET DEY 
137 89 GOTO 

138 8A RUN TXA 


140 8C RESTORE sTY$nnnn 
141 8D GOSUB STASnnnn 
142 8E RETURN STX$nnnn 
143 8F REM 


144 90 STOP BCC$nn 

145 91 ON STA($zz),¥ 
146 92 WAIT 

147 93 LOAD 

148 94 SAVE STY$zz,x 


149 95 VERIFY STA$zz,X 


orange 


F8 
SHIFT/RETURN 
upper case 


black 

cursor up 
ReVerSe off 
CLeaR HOME 
INSerT DELete 
brown 


SE ELE SR aE EE ER EE ETAT PP TO, 
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ie 
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SE SE I I STL TE a a PS OE TE TE 








DEC HEX BASIC 6510 ASCII 
OPS CODES 
ee 
150 96 DEF STX$zz,Y light red 
151 97 POKE light gray 
152 98 PRINT # TYA med. gray 
153 99 PRINT STASnnnn, ¥ light green 
154 9A CONT TXS light blue 
155 9B LIST dark gray 
156 9C CLR purple 
157 9D - CMD STASnnnn, x cursor left 
158 9E SYS yellow 
159 oF OPEN cyan 
160 AO CLOSE LDY#$ii space 
161 Al GET LDA($zz, X) graphics 
162 A2 NEW LDX#$ii ? 
163 A3 TAB( " 
164 A4 TO LDY$zz Kt 
165 AS FN LDAS$zz * 
166 A6 SPC ( LDX$zz x 
167 A7 THEN . 
168 A8 NOT TAY : 
169 A9 STEP LDA#$ii . 
170 AA + TAX ‘ 
171 AB 7 , 
172 AC $ LDY$nnnn " 
173 AD / LDAS$nnnn " 
174 AE - LDX$nnnn “ 
175 AF AND . 
176 BO OR BCS$nn " 
177 Bl > LDA($zz),¥ : 
178 B2 = : 
179 B3 « e 
180 B4 SGN LDY$2Z,X " 
181 B5 INT LDA$ZZ,X " 
182 B6 ABS LDX$2Z,Y " 
183 B7 USR mee 
184 B8 FRE CLV " 
185 B9 POS LDA$nnnn, Y " 
186 BA SQR TSX * 
187 BB RND . 
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DEC HEX BASIC 6510 ASCII 
OPS CODES 

188 BC LOG LDY$nnnn, X " 

189 BD EXP LDA$nnnn, X " 

190 BE cos LDX$nnnn, Y¥ " 

191 BF SIN " 

192 co TAN CPY#$ii 

193 C1 ATN CMP(zz,X) 

194 C2 PEEK 

195 C3 LEN 

196 c4 STRS$ CPY$zz 

197 c5- ~~ VAL CMP$zz 

198 Cé ASC DEC$zz 

199 C7 CHR$ 

200 c8 LEFT$ INY 

201 c9 RIGHTS CMP$zz 

202 CA MIDS DEX 

203 CB GO 

204 cc CPY$nnnn 

205 cD CMPSnnnn 

206 CE DEC$nnnn 

207 CF 

208 DO BNESnn 

209 Di CMP$($zz),Y 

210 D2 

211 D3 

212 D4 

213 D5 CMP$zz,X 

214 D6 DEC$2Z,X 

215 D7 

216 D8 CLD 

217 D9 CMPSnnnn, Y 

218 DA 

219 DB 

220 DC 

221 DD CMP$nnnn, X 

222 DE DEC$nnnn, X 

223 DF 

224 EO CPX#$ii ’ graphics 

225 El SBC($zz,X) ND 
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fe es, es jee 


oeel 


bese. Hees 


poe Cee Wee eee 


C 














HEX 
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6510 
OPS CODES 


CPX$zz 
SBC($zz,X) 
INCS$zz 


INX 
SBC$zz 
NOP 


COX$nnnn 
SBCS$nnnn 
INC$nnnn 


BEQ$nn 
SBC($zz),¥ 


SBC$zz,X 
INC$zz,X 


SED 
SBC$nnnn, Y 


SBC$nnnn, X 
INC$nnnn, X 
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MCS6510 INSTRUCTION SET 


ELLA ELT DS I TE RE A EE I Ea TE EST 


MNEMONIC 


DEFINITION 


SS NL FT a ES SE SE SL ET PED 


ADC 
AND 
ASL 


BCC 
BCS 
BEQ 
BIT 
BMI 
BNE 
BPL 
BRK 
BVC 
BVS 
CLC 
CLD 
CLI 
CLV 





Add memory to accumulator with carry 
AND memory with accumulator 

Shift left one bit (memory or 
accumulator) 

Branch on carry clear 

Branch on carry set 

Branch on result zero 

Test bits in memory with accumulator 
Branch on result minus 

Branch on result not zero 

Branch on result plus 

Force break 

Branch on overflow clear 

Branch. on overflow set 

Clear carry flag 

Clear decimal mode 

Clear interrupt disable bit 

Clear carry flag 

Compare memory and accumulator 
Compare memory and index X | 

Compare memory and index Y 
Decrement’ memory by one 

Decrement :index X by one 

Decrement index Y by one ms 
Exclusive OR memory with accumulator 
Increment memory by one 

Increment. index X by one 

Increment index Y by one 

Jump to new location 


~ Jump to new location saving Stark 


address 

Load accumulator with memory 
Load index X with memory 

Load index Y with memory 
Shift right one bit (memory or 
accumulator ) 

No operation 
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Ee 


[ee 


Les 


es 


ates 











a 








eon 


AS PS Ec Pa ES IT SSE IE tS EAE TIS 


MNEMONIC 


EL EL ET EET ESE TS ES 2 BRE OSES 


ORA 
PHA 
PHP 
PLA 
PLP 
ROL 


ROR 


SEA EE ES TS OE TD I I TIO I IPT LS FET IS TI 


<-- GENERAL MODE ORANGE --> 


DEFINITION 


OR memory with accumulator 

Push accumulator on stack 

Push processor status on stack 
Pull accumulator from stack 

Pull processor status from stack 
Rotate one bit left (memory or 
accumulator ) 

Rotate one bit right (memory or 
accumulator ) 

Return from interrupt 

Return from subroutine 

Subtract memory from accumulator 
with borrow 

Set carry flag 

Set decimal mode 

Set interrupt disable status 
Store accumulator in memory 
Store index X in memory 

Store index Y in memory 

Transfer accumulator to index X 
Transfer accumulator to index Y 
Transfer stack pointer to index X 
Transfer index X to accumulator 
Transfer index X to stack pointer 
Transfer index Y to accumulator 
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SYMBOLS & OPERATORS 


LS, 


SYMBOL 


FUNCTION 


QSL RESET TE EL I I EG oT a a STE 


~~ #1 + 
vu 


CMe er INVANVA Il 


ss: 


BD we —~ dP 


or = 


Arithmetic addition, plus 

Arithmetic subtraction, minus 
Arithmetic multiplication 

Arithmetic division 

Exponentation (raise to the tenth power) 
Relationship testing, equal to 
Relationship testing, less than 
Relationship testing, greater than 

Less than or equal to 

Greater than or equal to 

Not equal to 

Used inplace of the keyword PRINT 

The end of a BASIC statement 

Suppress TAB after PRINT 

TAB to next column 

Decimal point, may be used inplace of zero 
Identifies a character string 
Identifies a string variable 

Identifies a floating point variable 
Top priority in order of operation 
Signifies the word number 

And, also, in addition, to join together 


EA ARRAY BIS ER AES EE EE EE YE EI EE TE I LS EO OTTO 
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(ee Nis, Hees es Ee ee 


C2. 


co | ee es. ee ee 
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SCREEN FORMAT TABLES 





80 COLUMN SCREEN FORMAT TABLE 
| eS PS EE CEE OD DD 
To center screen text horizontally, (from side to side 
of the screen); If lines of text equal xx then enter 
TAB(xx) to center. 


TEXT LENGTH TAB XX TEXT LENGTH TAB XX 


TAB( 39) TAB( 24) 
TAB(39) TAB(23) 
TAB(38) TAB(23) 
TAB(38) TAB( 22) 
TAB( 37) TAB(22) 
TAB(37) TAB(21) 
TAB (36) TAB(21) 
TAB( 36) TAB(20) 
TAB( 35) TAB( 20) 
TAB(35) TAB(19) 
TAB(34) TAB(19) 
TAB(34) TAB(18) 
TAB(33) TAB(18) 
TAB(33) TAB(17) 
TAB(32) TAB(17) 
TAB(32) TAB(16) 
TAB(31) TAB(16) 
TAB(31) TAB(15) 
TAB(30) TAB(15) 
TAB(30) TAB(14) 
TAB( 29) TAB(14) 
TAB( 29) TAB(13) 
TAB( 28) TAB(13) 
TAB(28) TAB(12) 
TAB(27) TAB(12) 
TAB(27) TAB(11) 
TAB( 26) TAB(11) 
TAB( 26) TAB(10) 
TAB(25) TAB(10) 
TAB(25) TAB(9) 

TAB(24) TAB(9) 


WANKHMN PONE 


nnn nu to ut bt ton tn ton bn nh bt tt on non non nn 
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TEXT LENGTH TAB XX TEXT LENGTH TAB XX 


40 COLUMN SCREEN FORMAT TABLE 
RL ERNE PIONS OLE PN SEN CAS PRE FOR INGORE AY al MES CAEN DT AEP EINE GEE SEPT AEE SIE PIE ESB INEPT 
To center screen text horizontally,(from side to side 
of the screen); If lines of text equal xx then enter 


TAB(xx) to center. 


= 
= 


TAB(8) 
TAB(8) 
TAB(7) 
TAB(7) 


ct ct ct ct 


tout nba town 


TAB(6) 
TAB(6) 
TAB(5) 
TAB(5) 
TAB(4) 


yaw 
oO oO 
OM 
cr ct 


4 
oO 
Lal 
ct 


TAB(19) 
TAB(19) 
TAB(18) 
TAB(18) 
TAB(17) 
TAB(17) 
TAB(16) 
TAB(16) 
TAB(15) 
TAB(15) 
TAB(14) 
TAB(14) 
TAB(13) 
TAB(13) 
TAB(12) 
TAB(12) 
TAB(11) 
TAB(11) 
TAB(10) 
TAB(10) 
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hunkut nt t btn bb toe tow tu 


TAB(4) 
TAB(3) 
TAB(3) 
TAB(2) 
TAB(2) 
TAB(1) 
TAB(1) 
TAB(0) 
TAB(0) 





TAB(9) 
TAB(9) 
TAB(8) 
TAB(8) 
TAB(7) 
TAB(7) 
TAB(6) 
TAB(6) 
TAB(5) 
TAB(5) 
TAB(4) 
TAB(4) 
TAB(3) 
TAB(3) 
TAB(2) 
TAB(2) 
TAB(1) 
TAB(1) 
TAB(0) 
TAB(0) 





Gas “ee. Nee “Ge, Me 


(eee as 


ees Ces 


Gee Sees “here, ee 





ES, eee 
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SS AEE BE PT ET TT SE EO 


25 ROW SCREEN FORMAT TABLE 


ADS PER DS OE EE SE ED 


To center text vertically (from top to bottom): if 
lines of text equal xx, then begin the text on row. 


TEXT LINES BEGIN TEXT LINES BEGIN 


WON DO SW D Fe 
Hun tout weu how 
HPNNMWO PS POUAA~ 
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STANDARD ABBREVIATIONS 


Asynchronous Communications Interface Adapter 
Advanced Data Communication 

Advanced Data Link Controller 
ALGOrithmic Language 

Arithmetic Logic Unit 

American National Standards Institute 
Automatically Programmed Tools 
Acceptable Quality Level 

Automatic Request for Repeat 
Audio-response Unit 

American Standard Code for Information 
Interchange 

Automatic Test Equipment 

Automatic Test Generation 


Beginner's All-purpose Symbolic Instruction 
Code 

Basic Control System 

Binary Coded Decimal 

Basic operating System 

Bits Per Second 

Binary Synchronous Communications 


Computer Aided Design 

Computer Assisted Instruction 
Computer Aided Manufacturing 
Charge Coupled Device 

Current Mode Logic 

CoMmanD 

Common Business Oriented Language 
COordinate GeOmetry 

Computer Output Microfilm 
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LP A NE ER EL a IIE IE ITI 


ECL 
EEPROM 


EFTS 
EIA 


Computerized Numeric Control 
Computer Power Center 
COMmunications SATellite 

Central Processing Element 

Control Program for Microprocessors 
Central Processing Unit 

Cyclic Redundancy Check 

Control Read Only Memory 

Cathode Ray Tube 


Data Access Register 

Data Acquisition and Control 
Digital Analog Converter 

Data Base 

Direct Coupled Transistor Logic 
Data Element Dictionary 

Data Input Bus 

DIRectory 

Direct Memory Access 

Direct Numerical Control 

Disk Operating System 

Data Processing Management Assocation 
Device Status Word 

Data Terminal Equipment 

Diode Transistor Logic 

Data Under Voice 


Electrical Accounting Machine _ 

Electrically Alterable Read Only Memory 
Extended Binary Coded Decimal Interchange 
Code 

ElectroChromic Displays 

Emitter Coupled Logic 

Electrically Erasable Programmable Read Only 
Memory 

Electronic Funds Transfer Systems 

Electronic Industries Association 
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SL SE LL A I ET I EP ES EP FE SE TI 


FIFO 
FORTRAN 
FP 

FPLA 
FSK 


LCD 
LIFO 
LSI 


End Of File 

End O£ Message 

End Of Transmission 

ENquiry Character 

Electrically Programmable Read Only Memory 
EXECutive statement or EXECutive system 


First In First Out 

FORmula TRANslator 

Floating Point 

Field Programmable Logic Array 
Frequency Shift Keying 


Garbage In Garbage Out 


Integrated Circuit or Instruction Counter 
Institute of Electrical and Electronics 
Engineers 

Input Output 

Initial Program Loader 

Indexed Sequential Access Method 
International Organization for 
Standardization 


Keyed Sequential Access Method 
Keyboard Send/Receive 
KeyWord In Context 


Liquid Crystal Display 
Last In First Out 
Large Scale Integration 
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M 
MICR Magnetic Ink Character Recognition 
MIS Metal Insulator Silicon 
MKS Meter Kilogram Second 
ML Machine Language 
MOS Metal Oxide Semiconductor 


MSI Medium Scale Integration 
MTBF Mean Time Between Failure 


MTF Mean Time to Failure 
MPS MicroProcessor System 
MPU MicroProcessor Unit 

N 
NMI Non Maskable Interrupt 
NRZ1 NonReturn to Zero one 

oO 
OR OpeRator 

Pp 
P Power 
PAL Programmable Array Logic 
PC Programmable Controller 
PERT Program Evaluation and Review Technique 


PIA Peripheral Interface Adapter 
PLA Programmable Logic Array 

PPL Phase Locked Loop 

POS Point Of Sale 

PROM Programmable Read Only Memory 
PRT Program Reference Table 

PSU Program Storage Unit 

PSW Program Status Word 


QAM Quadrature Amplitude Modulation 





ey? 


RAM 
RCTL 
ROM 
RTC 
RTE 
RTL 
RZ 


SI 

SIO 
SOS 
STRESS 
SYSGEN 
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Random Access Memory 

Resistor Capacitor Transistor Logic 
Read Only Memory 

Relative Time Clock 

Real Time Executive 

Resistor Transistor Logic 

Return to Zero 


SuperImpose 

Serial Input/Output 

Silicon On Sapphire 

StrucTural Enginerring Systems Solver 
SYStems GENeration 


— OU 


Telecommunications Access Method 

Time Division Multiplexer 
Transistor-Transistor Logic 

Universal Asynchronous Receiver/Transmitter 
UltaHigh Frequencies 

Uncommon Logic Arrays 

Universal Block Channel 

Uninterruptible Power Supply 


Voice Answer Back 

Video Display Generator 

Video RAM 

Vertical Redundancy Checking 
Virtual Storage 

Vortax TelecommunicAtions Method 


Word Processing 
Words Per Minute 
Working Storage 


ERR RN AE ELLIE EOP ET DE TIA SET TES CTE EC A TE EE ET 
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CASSETTE COMMANDS 


. Load next program on the tape 

Load first program on the tape 

LOAD"name",1 ...... Load machine language program 
LOAD"name",1,1 ..... Load to proper place in men. 
LOAD"T" ......... Load first file starting with T 
LOAD"Jan" ..... Load first file starting with Jan 

. To save file in memory to tape 

SAVE" Jan" . To save program named Jan by name 
VERIFY Compare file with one in memory 
VERIFY" JAN" Compare prog. named Jan to memory 
OPEN File open for recording info 
OPEN .... Opens file 2 for recording SEQ. file 
OPEN 3,1,0,"Jan" ....... Open file 3 for recall/SEQ 
OPEN Open file 1 for recall next SEQ file 
OPEN 1,2,"end of tape" ... Open file 2 for 
recording file called END OF TAPE 

OPEN 1,1,2:CLOSE 1 End of tape marker 
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PERSONAL DATA GOLD 


EQUIPMENT PURCHASES 231 
EQUIPMENT REPAIR 237 
SUPPLIES 243 
DISK ID's 247 
BULLETIN BOARDS LOCAL 252 
BULLETIN BOARDS NON-LOCAL 256 


This section is intended to record personal data such 
as: serial and model numbers of equipment, what store 
has the best buy on printer ribbon, your favorite BBS 
number, all the things you were always going to write 
down but never have. The pages labeled DISK ID's con- 
tain, a set of pre-assigned disk ID numbers. Several 
months ago I was looking through my software and dis- 
covered, a number of disks, with the same ID. The nu- 
merals 64 seemed to be very popular. The problem did 
not sink in until I attempted to move a file from one 
disk to another. The drive immediately became muddled 
over the duplication of ID's. I promptly made a chart 
of new ID's and assigned each disk a number. Now when 
a disk needs to be formatted I check the chart to see 
what the ID should be. 
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EQUIPMENT PURCHASES 





EQUIPMENT PURCHASED _. 


roenen soonmmennecoosunces utes tesemuevtenenecesern wereeteuneentssiaestensessvennesseenensscenessenan tite 


PURCHASED FROM en ene 1 eA PC Re ene Renee Ae eI 
ADDRESS: 
STREET Sa ee an ea ON NT IEEE ON OER ee 
LOG bs Ge “acer | a te lie as he ee CR a 
TELEPHONE, NUMBER cmc ccs ec ee sal 
DATE BOUGHT a ial atic es a a 


WARRANTY EXPIRES 


vocouaneveronnvanosneneesiesspecsonnanensssuvetessaeve stsnuvestousenssanateseansetengeeneeneesamemennuenoeneeens stessnunseoeannetecnuneesonseteess se eerttenen testes? 


SERIAL NUMBER 


sovmnevssonnecesonnnvoctanvenencnuvenionsnverssenneccenianeasnacesnneasvereouansssstennensosesbsecsns sone ssansnvesenniseneeconnes teuneessset steerer secesbovensenenect®, 


EQUIPMENT PURCHASED issivmcinticwivinnieninnnnititt imei acs satsta tists 
PURCHASED FROM ecpeehet reece eee eee erence 
ADDRESS: 

SIRE 8 8 fakeeislace steno anata mnnateanaananentyaaduoamamaias 
CITY & STATE i lh i aac aa 
TELEPHONES NUMER schemes 
DATE BOUGHT SL i a ei ace gt = 
WARRANTY EXP URS ceca hmm 5 
SEREAL: NUMBER cepese tcc cc lta a acta cam acemtiitartons 


(-- PERSONAL DATA GOLD --> 


EQUIPMENT PURCHASES 
SL I LR LT I SE BSL ED 
EQUIPMENT PURCHASED cececoeccsnncnnennninurnnninssnssnntmmtnneninntinanminninuiintintn 
PURCHASED FROM Sad saa aaa rc aaa ar 


ADDRESS: 
STREET Bape cg lila aes 


CLT Se STATE eerie aethmaelae 


TELEPHONE NUMBER nn eneeemneenenmnnereneennctnennunnneieintin 


DATE BOUGHT ees acta atau taal sa 
WARRANTY EXPIRES ccccnsnnnsininninuniinunninnnsinnnninnninnmnnnmnmmnnniinn f 
SERIAL NUMBER Baas teal cata eed onc a 5 
a NE PT EE ELISE SAE EE 
RQULPMENT: PURCHASED csisccsictccsdickceastmenes decanter ee actin ee 
PURCHASED FROM Ba Sa eter Nap nua a ech ecules om 


ADDRESS: 
STREET a ce a aes 


CITY & STATE a Ea aah NI i as eee as e 


TELEPHONE NUMBER sce ccisinninipinnircnapiennnbaaiasa eee 


DATE BOUGHT sce esate i atlas daa 
WARRANTY - ADE RES separa acne tas tec a 
SERIAL NUMBER waa AA Tas a eae itech i cS aaa 


a I EE) 
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EQUIPMENT PURCHASES 








EQUIPMENT PURCHASED = 
PURCHASED FROM Se ee 
ADDRESS: 

STREET 7 

CITY & STATE 
TELEPHONE NUMBER _ 
DATE BOUGHT Ea eee 7 
WARRANTY EXPIRES _ 
SERIAL NUMBER = 





EQUIPMENT PURCHASED itera tactic gale led 
PURCHASED FROM ei ecient pepceoiaoaie 
ADDRESS: 

STREET Peer alec > ees Shee nein se ee teeters ea ere 
CITY & STATE ae a ae Te et 
PELEPHONE (NUMBER sos section nitions iecletameienttnts cai siaaliati 
DATE BOUGHT pl tect aap accel 
WARRANTY EXP URES jeanne ee anc aa 
SERIAL NUMBER ee ee ees acter ee atcha ieee cole = 


<-- PERSONAL DATA GOLD --> 


EQUIPMENT PURCHASES 





EQUIPMENT PURCHB SED isc stetchencetreeepnabeect 
PURCHASED FROM CR a Ree ee NEE een aN 


ADDRESS: 
STREET ere TT ER OORT ED TONE ee a 


CEU Ye STAT «aaa cca emr eo 


TELEPHONE NUMBER nics ttt 


DATE BOUGHT settee ante ast masa tla acta aan 
WARRANTY EXPIRES nineties 
SERIAL NUMBER acaba an la esc Sa e _ 


A 


EQUIPMENT PURCHASED oe eee — 
PURCHASED FROM (0 ceceeeeesueemnnneevommmmnnnreereneernereneron — 
ADDRESS: 

STREET ne Dae ees 
CLG SUNN Sew ee hee 
TELEPHONE NUMBER 
DATE BOUGHT cee ener = 
WARRANTY EXPIRES cece eee — 
SERIAL NUMBER 





bee 
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EQUIPMENT PURCHASES 





— EQUIPMENT PURCHASED ec eecneeewneeeeerennnennnnnnntnnn 7 
PURCHASED FROM 0 ceeenwnnsnenieesnnnnnntntnnunsennn ee 
ADDRESS: 
STRERT 00 Wisse eel , 
i Sea) 4 eae ee eS 
PELEPHONE: NUMBER: so estat a corte 
DATE BOUGHT Biasg 
WARRANTY EXPIRES cece enennnunnennn : 
SERIBU-NUMBER cacsce ature ir ee ak ace 


BOUTPMENT PURCHBSED® ic ioscsisiti hes tvs atl a oases 
PURCHASED FROM SS a ata apical tela 


ADDRESS: 
STREET atlanta aah a ac aes ae ee oc a =i 


Oo et ab: 2 Oe ne ca ace ae eee eee 


TEUEPHONE (NUMBER tc cctice ppm laetee alan tee s e = 


DATE BOUGHT ia aecaessttnt AEE Caceat STs er a lt i a ee ns 
WARRANTY: EXPIRES sisi cise ates cl te ie tS  accnaamaaan 


SERIAL NUMBER digit oot a oe a ne 
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EQUIPMENT PURCHASES 





U 
UJ 
EQUIPMENT PURCHASED i 
UJ 
U 


PURCHASED FROM aR een Rem TA er 
ADDRESS: 
STREET fae eee NN a eee eee | 
CGA ec \ | cd ene ce | 
TELEPHONE NUMBER ecncnccecnene-eneweneeneveeemnenmnennunenns _ | 
DATE BOUGHT — | 
WARRANTY EXPL RES ccc ee ceeeneteneeeenee tne i: 
GERTAU NUMBER. —ceedaceamet cc Saateaumtianenancam ictal ” | 
EQUIPMENT PURCHASED 2 acceso eee ee LU 
PURCHASED FROM eae area ee ae 
ADDRESS: i 
STRERR seacoast 
CIPY ee STADE. eats ee cee me ON L 
MEUEPHONE: NOMBER eset eee Set eet i 
DATE BOUGHT Se as ee ted tee 
WARRENTY EXPIRES etic ecm eee le ees 
GERTAL MUMBER Siecle aa 


feo Wee We 








4 


J 
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EQUIPMENT REPAIR 





EQUIPMENT REPAIRED enn 
SHOP NAME aera ee re, - 
HOURS eral ai AE te a a ns acs 
ADDRESS: 

So 4 oy er eee eee eee eee ee 

se kW Re 
TELEPHONE, “NUMBER spinnin ti . 
CHARGES ae Resa cas Depa sll aaa ca an tn DE ts = 
WERRANT cscs ec a a a a al sie 
85 4) | i be eT ee m 


EQUIPMENT REPALTRED ccc ceeetee emcee ene een < 
SHOR NAME ies esa ate rete a Rn el “a 
HOURS) 000000 tephra ee ek les 
ADDRESS: 

STREET sania 

CTY: Be T AT ccc iS ach tk ee ss 
TELEPHONE NUMBER nn ecccenennssnennnnntnnennnniiinisimasnnrininnmninanmmininiinnt 
CHARGES Sess a a a ocean 
WARRANT © pect centered, 


COMMENTS Sia ay aa au pe Seen eterna sac ea a 
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EQUIPMENT REPAIR 


a IE TO STS EES 


EQUIPMENT REPALRED 2cccccecceecseeeeceeeeeereeetmeneinntnnnnttt 
SHOP NAME ict cae hppa ze 
HOURS sei a ae tara pee ounces 
ADDRESS: 

STREET 000: Se ee et cerca: ran 

CITY @ STATE ee eo 
TELEPHONE NUMBER nnn ce ncn 
CHARGES se ee i a eden 
WARRANTY ol a a ie lito REA aliceds 
COMMENTS Sea Se ak a aa eal am eae aon 


Se LE, 


EQUIPMENT: ‘REPATRED® }scssctsmicescaninntaincccitesil etter et aces 
SHOP NAME Sh a Se ct let ce alsa 
HOURS a tO a eT 
ADDRESS: 

STREET EA aE SAE ONE PIS EO ONT ET Ne eT ee ATOR 

0:9 Me ae 72 oy Ws Oceano es neler cence en Ce sei 
TELEPHONE NUMBER na tetas 
CHARGES a De at aa at te 


WARRANTY eR a eee Te OTE 


COMMENTS 


(a2... (GS Hee 


(i. Se. Hea: Hee 





Bee eee es ee Ve, vie 














<-- PERSONAL DATA GOLD --> 


EQUIPMENT REPAIR 





EQUIPMENT REPAIRED: qm tt 
SHOP NAME Sa ae aaa inecaca ai as 
HOURS Sct ees ate t, x 
ADDRESS: 

REET apkece ante iin as tal is ist 

CURVE: STATE) cic ede t tame ede ec 
TELEPHONE. NUMBIGR 52s epee ce a as ‘ 
CHARGES: = «cesses rr ret uas ae aaa 
WARRANT rpettcrstneentnctneetn i oe ee be 
COMMENTS ea oe aN Noe an rae TaN EP ORE Sem eon 


EQUIPMENT REPALRED occccceccweecrvveewnnernevninnnnnnnnnnrnnmnn : 
SHOP NAME: 00 seep sh 
HOURS? gee Gc eerie AL, ; 
ADDRESS: 

STREET 00 eg ee ee 

GUY SUA secretes Se rae eae 
TELEPHONE NUMBER 2 cccccccccceeveececeweveerecnrneneennenne tenn : 
CHARGES eae tee eer om Pe ee eee cee eee 
WARRANTY. veces Seatac s 
COMMENTS enn = 


<-- PERSONAL DATA GOLD --> 


EQUIPMENT REPAIR 





EQUIPMENT REPALT RED cccecceeecneceene ee emeeeetenneneneenecnen 
SHOP NAME aie Re nee SPREE ORO Att een eed ee en Peer 
HOURS Sn Se Sere On ee TNE ee IEE ete See sel 
ADDRESS: 
STREET Preclitie nN One fees en teint i nr mienicnieenes terrane ae 
CITY: &.STAT Esteem 
TELEPHONE NUMBER ccc cceceexneneneeeeeeerenmee 
CHARGES tale ce aa 
WIRRAN EY = cise lat aatlaardee cates ener e 
COMMENTS Seip Sacssac  tela eo neraTney Weta) 


EQUIPMENT REPAIRED eens 

SHOP NAME Se ot ee CO NNT IC NC 

HOURS ‘ao ates gpa 

ADDRESS: 
STREET Sie A ee aah I a neat ta te Dac 
CETY STAT ce eens 

TELEPHONE NUMBER 

CHARGES iii Tas 


WARRANTY See 


COMMENTS eT See ee ET ERE TO 


Es 











«-- PERSONAL DATA GOLD --> 


EQUIPMENT REPAIR 





BOULPMENT REPAIRED : octet aga cates 
SHOP NAME Fea ea im asa ie ce Se tiie 
HOURS Fn ae ORE LER DROS RTE OT EA OTE TED 
ADDRESS: 
STREET i ea a aA i aa tS aaa - 
CET: SBT AT Ee «testa oa sca pales 
TELEPHONE NUMBER Ee ea 
MCHARGIO > Sere i ocean laa te a ace : 
WARRANTY: ascot xterm 


COMMENTS ie aan ea Da I eC ta ae 


EQUIPMENT REPAD RED snc stpintencnientniaiminniiitn tl acl 
SHOP NAME =§««-«- «== Siteanrictachnnttannauealoma aaa ane See 
HOURS Sec aa lt li asl 
ADDRESS: 

STREET gee he oes ee a 

CITY &-SIATE. 2.2 eee ee e 
TELEPHONE: NUOMBIER icc access stint nnegensininlninins meen sna 2 
CHARGES Sg act tet aS ak eet eo SRO ea done ‘ 
WARRANTY saa a iP ean i ai sd cp ee 
COMMENTS 5 rcs snc ear litle io centerpieces . 


(-- PERSONAL DATA GOLD --> 


EQUIPMENT REPAIR 





EQUIPMENT REPAL RED npc cetecpscemmenier einen 
SHOP NAME eae aN eve ee edie ee cecnene eer 
HOURS sO aca NS es a eee eS 
ADDRESS: 

STREET Sanat ace ieee al NE 

CUTTY 6° STATE nie eee ee ms 
TELEPHONE. “NUMBER inact pnts treet ent ae nee 
CHARGES PRRs cee ads ERY es PER Ser ave a NC ss 
WARRANTY Sap Pac i a a I a tl 
COMPING eee el een 


SS IP EE TED 


FOULPHENT REPAURED caiecsctsicuntstinutcmnninrninatiiaitatsnonicniiisiamasstaitaiiaases " 
SHOP NAME POENORs OPEN a SPE A ON em TON ee esa Re Les 
HOURS a a ta anaes ec al 
ADDRESS: 

STREET em artr eane BOSE Sexte orew DE NEAT 

0:8 is rah | A nee eee oe eno Re OD ence Per OO 
TELEPHONE NUMBER ci psccteitccmntiiinitietaraboncim aa 
CHERGES. —sctussas conical coat en sae eee cel ae ah il ad 
WARRANTY Sea Da aK a Rae Sa 
COMMENTS ea enc eRe SOR SEE IST RUREE IT FEC OREM eT Te 


[== je. (ee ee. CS eee ee SEs ie: tele 


eae, SS, eee 

















«-- PERSONAL DATA GOLD --> 


SUPPLIES 


LA ME I TE ST ES SO I I I TI EL EESTI 


yf 1 pment see ear Socnn ee ne OO PRICE schireecmcettectnnciacie 
PURCHASE FROM ee ee TSE OEE TOE RE OORT be 
ADDRESS: 

STREET NE aa a IN sel Nace 

CMEC SIbie> .aSs 
TELEPHONE NUMBER © cscs shecttactat O 
COMMENTS a ree ts 
3 , enna Se nn, Ste een ON a OEE er Pe 2154 &) geen ee aC 
PURCHASE. FROM) ctscel areas ineeinterns 
ADDRESS: 

STREET Ee ee ae ee MS eS MTSE a ae ate ~ 

CU TY ROP LI : - seera site itaadenmee anlar er taal ks —_ 
SEL EPHONE< NUM IBIGR sissies cetirtcadiataaaates 
COMMENTS Hi lta TE tte a lS Sa a 
TIEN eek eee eae ao PRICE 22, 
PURCHASE FROM ~ socinmitinstesininemtiorgtaliey Sse Os ea Se as 
ADDRESS: 

STREET baa i Staite Sat Tate eS Te cad = 

TY ihe ET 5 ce ae i . 
TELEPHONE: NUMBER: tecscciciccmintsiet.cicninn tin anmnapeiiat its matnastruesiatst ado 
COMMENTS SO cea ie et le a 


<-- PERSONAL DATA GOLD --> 


SUPPLIES 





SE cy Rec sas nti see PRICE sestonicinisatanincsiia ton 
PURCHASE FROM Fee eR TE TESS ATE SAE AE TOR 
ADDRESS: 
STREET NE ce eT EI OR ee en ae en 
CITY 6 STATE  s2e ee ie ee 
TLE PHON SS. NUMBER cacao bes 


COMMENTS opt ae Rae eee een m 


enamel 


TDIGHs <csvseesescnlastsee tk as ag le cae a atl wl PRICE csscccccssinciinesintat 
PURCHASE FROM Sie Da Ee ad Sse tu cecnaapeene eum areas 
ADDRESS: 
STREET i a a an anal aati 
CITY STATE citer centennial se 
TELEPHONE: NUMBER citiic icici ciate Stati anata ionai matt ' 


COMMENTS © ah ch ele ee ete ede 


lb ) _ pcbanay ere er ee REE eo PRICE esscseecsitrctces 
PURCHASE FROM rae are ee ae PE OREO 
ADDRESS: 
STREET Se Ne a ie ie aca cet 
ON ik er een PRR EE TO OPEN er 
TELEPHONE NUMBER sc cccecnceeeceneceeeeeeneteeeneeenenneente ene 


COMMENTS Sa ga eagle aces 


(i, “lee Jee wee. es ee? eee ee, RE Ce es hee Ge Ee 


«-- PERSONAL DATA GOLD --> 


SUPPLIES 

















TOTEM: scosnsisnien pom eerste le at atest PREC pentane Beebe 
PURCHASE FROM Uae ita tence dence ase eet 
ADDRESS: 
STREET x aN Ee Te Sete REE Oe ee ET IO NE Ce 
COTY Se STATE criceiiectietactiaiemica i 
AEE PHONE NOM ER ic htt cere miac 


COMMENTS Lees a ae eee Fee ee rene rae 


Se» are re ee ecco obo oe PRICE pavements = 
PURCHASE FROM SE IO ee EN ea ee ae N - 
ADDRESS: 
STREET ital i Ih ale Casino all Sic 
CLEY 6: S0AT Ge “vee ee ea 
TELEPHONE NUMBER cocci se es 


COMMENTS Sse aac la te Baa ea 





PURCHASE FROM iia pias tac tie tala act at: 
ADDRESS: 
STREET ii i epee aaa cee cee 
CLT SSSR TE acs ae ee 
TEEPHONE: NUMBER ccc staf se 


COMMENTS as pea aa ec ae atc 





{-- PERSONAL DATA GOLD --> 





SUPPLIES 

TT cece gs St win PRTC sieninntannieiini 
PURCHASE FROM Sa a haa aN inate ce eee 
ADDRESS: 

STREET LS AEE PE EI Oe RR 

CUTTY Se STATE cosinsnticlstmecaanint hiatal aaa 
TE TEPRONE, UBB R cc  l 
COMMENTS Si ge ease ate aren aaa ay a 
SIEM cscs alle ias acre eaten PRICE ccrcnpecnces 
PURCHASE FROM STA Re eR EE Oe RACER SAE TERME ARTE PE 
ADDRESS: 

STREET Sei ke ce at Se ate at 

CEDY 6 STAT: aceite tect terre ti ieee eadtat tae ca = 
PELEPHONE NUMBER, csicsccctsscrcssrcpstiiai site e al eta 
COMMENTS a a a a Si a a ec 
SP PCE | justrtcenntstatcridenalatsagiyitiiisinnesiaiilearegiitinineh PRE CE. Siete sepsiaateaanisia 
PURCHASE FROM ihc A a A ie i east 
ADDRESS: 

STREET ia alae Re ta ae ee oa mn 

6 el ip daa Rete Re ni Nar entrees En ener MRR CRE ee 
TELEPHONE NUMBER oT 
COMMENTS Sic lac ates il alia ace at 





‘om 


C2 «ES lex 





we 

















ames | 


<-- PERSONAL DATA GOLD --> 


DISK ID‘s 


The ID of a disk is an important factor in the format 
process. During any disk operation, the drive checks 
for a unique identification. If two diskettes were to 
have the same IDs, and you wanted to move a file from 
one to the other, the disk drive would become confus- 
ed by the duplication. Once the program was in memory 
the drive would not know where you wanted the file to 
go. The following list of pre-assigned ID's, are all 
different. Next time you want to format a disk, just 
allocate one from the list. 


Some letter combinations have been left out, because 
of possible conflict with keywords and disk utility 
instructions. 


AR. ANLuW.. -BBW.... BO ccs OC tied SOP ap ccis 
|; 1: cera: | 9 Seno BC BP ee, CD cee “CReemeene 
| Oar ea | «SRC BD BQsccc.- Chinkee., CS 
BD setts AO ats BE... o> BRowos. CP se CT aude 
BE nase. [| nes 1) een Beene Closes: CV 
BP estos AS. 2. BGs BP cs me ©, nee CW. 
AG aise: AT BD ae BV CT aes, “Chua 
AH inna BV et aes Bian BO. ON See S) eens 
Alene CAN BIS. 2 Brees, pe. TORS Cairns! 
BG vousisiatenae Pidbsonsiannee | BNanccetit BY caeucas 2; Pamameneneonmen B). eenemte 
BR ssa: AY cc, “Bi teciicas Boassi 3 CM, DB icone 
Becca Givin: EM isin’ ACP cect CNucea DG cia: 


- 247 - 


So” 2 oe) sd) 


(-- PERSONAL DATA GOLD --> 


BAL BN CB CO DDL 


AM es 


HO scenes 


Fi. GS... HP. 


BiG esate. + beatae 


DF ks 


PAS ce. . Xen. GT HR, 


|) eens 


DG nso 


EB seccce SFB oe PY es (GV HS 


15, aeons 


EEooes PCa. Poe 


Dies 


|e | | LC]: nL cons ; || Seen 


LS eens 





GVscce “HW: 


|}; es na C;: erin 


DK es 


 6C 


HR cctcncs 


GL nen 


| 5 eee: oh omnes 


DD icine 


Bdwescied EG cect: GD ac UB ccs Linas 


DN 


|; | Sennen Ut Wrenn 


Bb snc UR Te CP 


DO cists 


AD voscitintis «A Biindacins 


[nn I ns CC Sana 


DP i. 


Nee CPR ee, CH ee (HB eee (Te 


DQ. ane 


PT smncasts 


FP ecsiostiins, “ah Das 


Gite 


EO... 


DR nieinninnins 


HG TE 


LC ara 


BP re: Me 


DS ise 


j Perey 9 peer 


GK enna 


EQ. FN. 


DD ooestncts 


Hine, Gees: 


BRizcis. FOneis Ghia 


DV nk, 


idl 


1 Reeeerenemae , eonew meee 


Poet EP Glass 


| 


Ghee Hh Ip 


5 ieee © meme 


aero 


5S commonest 


.C, | Hane ecna | F OReneen 


GV vicsnl, TOR sree 


DY cscisidcias 


HM. Te 


BW oes FS cece GPs 


DBs 
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—_ 














EQ ete 


JK 


DLs sista 


<-- PERSONAL DATA GOLD --> 


RO teen. EM ens 
KP rincitnns LN eens 
| {| ae LOA ans 
L aa wie LP idence 


|. |) 


<-- PERSONAL DATA GOLD --> 


Ksuswe. Lies ME. NBooe NYo 


Osc (Pie: RP, SNe “Thee 


\ 


OV PS RO SO. TM 


0): 


| | 
= 
= fam 
e i=] 
jd 
_ 
P| 
a oa 
wn wm 
i 
i z 
a 
w Ex 
[2-4 [a4 
a 
i i 
i i 
=> ic 
Py Pu 
H H 
: i 
} } 
i i 
™N «ct 
[o) Ry 
P| 
[22] oO 
(en) ([@) 


eet eel Be 


neveceaneccenee 


PBs PR. RVeee SR TO 


OD neni 


TR 


Sans 


RW...... 


PY cates 


1 een 


RX ST 


PDs. Pha 


OF sins 


PR RA RV oe OV Te 


OG vinci 


Ro nete,  PWeaee PV 


RB sccnscsian 


OH PP. 


DR sccessadse: <TR atinenacener 


PCr? RO seo SA 


Ole 


Bese. OV cect TYE ts 


Picci, “RD 


101 femme 


oles Aaa 
ae 
i nn  *} 
e+ > Sf 
Nn cc 
non &: =F 
Rok o 
} | | 
$ 206i 
me 
Oo ff & 
n wa wm 
i 
Be 
ae ee 
i] f& © 
ae wm 
Po | f 
if 4 
‘a aa 
en 
HH > 
a wo AW 
a oes | 
Pot 
Bs 
a oe >) 
oOo oO oOo 


ae 
i | 
| | 
cba 
> > 
| | 
j i 
oO aA 
eS E& 
H H 
| | 
i 
& © 
wm Ww 
a 
nm 
} i 
i i 
io DE ae | 
RQ & 
i ? 
Da 
z 
yl 
qa 
a 
| | 
a Aa 
Oo oO 


PNesciece: (Rowe “Sie FReese, Viton. 


0] ¢ keene 


Be cates, | VE cee 


i. 5 Ree 


PO stint RR ne 


0) : ae 


UGeecss! “VG. 


Sis: 


PP RE. 


OS ncaa 


el 


TH Sie. VAL: 


PQ ete: RA BK, 


OF ccs 


Dest: | Ni ores 


PReteiis: RN bee Slices. 


OV so 


ee 
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OW... 


| oe 


ND sates 


Vi... 


Veo 


WA 


| ne 


<-- PERSONAL DATA GOLD --> 


i 


|: Sane 


» { oioemnmems 


ROji.! ON aencs 
| a) |: Seeenee 
Be vscciiwntirn.. 2M Comet - 


XGo en YD ee 


XU cee : { ¢ anne 
RRe se bd era _ 
9, | Fenner: 4 Sees 
> |. enn 2 eee 
RN! YR 
) (¢ ceemeneneaa § Panamera 


Those 
:f eee 
| er 


BBensiiscses 


<«-- PERSONAL DATA GOLD --> 


BULLETIN BOARDS—LOCAL. 
a ar ey 
BOARD NAME cecceceeeeteeeeee eee _ 
OURS 0s bee arheeneee ee tee 7 

TELEPHONE NUMBER cceeenusnenennnvnenenennnee 
CHARGES Y/N Sides eee ene 
PASSWORD: sate apes ce ad 


COMMIT cic a ares ee 


A I EB PE EE ET 


BOARD NAME cette See ee ee = 
HOURS eins aie aa det I a etl oa, 
TELEPHONE NUMBER RO Ree ere ot oer ts nee Mee aD Ame te nen ae re 
CHARGES Y/N Seatac cere a a ar 
PASSWORD. ope a a a a 
02] | |]: bi anne ee rr NC MRED oe Cane nrc = 


SN SE SE SPR EE SE TI SE 


BOARD NAME Ss tase omsanspgaant 

HOURS iat a ites 
TELEPHONE NUMBER OAT RT NAD ON NE SEON AT Ran el nee PROPS gy 
CHARGES Y/N Saran ata cae el es ss 
1s] 1sts|. | 0]: meen nero ele tr Scan ee ioe even erat et See ec aes8 
COMMENTS LET eR REA a ETT RTO aN TOE 2S RIEU SENT PITT 











ees | 





«-- PERSONAL DATA GOLD --> 


BULLETIN BOARDS-—-LOCAL 





BOARD NAME Sl at hl ee ten Aa Ree Ta baile 
HOURS acca le eielasacno at esc niE A S , os 
TELEPHONE NUMBER eee iain ee ar as 
CHARGES. Y/N sisi aca el dre ee Se a 
PRS OW ORD sshd ec pace Se gS eee Sh IS lt erased tee 
0: 0) 1.1: is 2 ene Pee es eee Ree Oe ; 
ss lS 
BOARD NAME Sacer cea arti he Races Racer a 
HOURS SS aa ceca kar scale lay sis 
TELEPHONE: NUMBER iccsicssiniiinintiiticinisihinie adit tual aa stages acini 
CHARGES Y/N Paneer Cm ee ERE AINn ee oat ee re eee nea mee SN css 
PASSWORD <c..6co ee eee 
COMMENTS: csi tt 
BOARD NAME ca ala acai ae a tact 
HOURS Spice a a etn ea ste 
TELEPHONE NUMBER ei Seo aa 
CHARGES: (M7 hese ae raat s. 
PASSWORD: 23 ee iret tent con ep cinere  Rt 
COMMENT Steet aed iam eee 


+293 = 


<-- PERSONAL DATA GOLD --> 


BULLETIN BOARDS—LOCAL 





BOARD NAME Reco re ome pein eaaaames 

HOURS A Ri aE a tt lca metres 
TELEPHONE NUMBER Sac Si a aE it tern 
CHARGES Y/N Ge pt ha aa Racin alae Seaeanerntee 
DSS WORD: csp ne le se 
COMMENTS © iain nie 


ep SL I 





BOARD NAME pn secs tld ast 
HOURS aaa aca li msec ee aa chaser 
TELEPHONE NUMBER Bi aa ha che ape ee a 
CHARGES Y/N epee ae td 
PASSWORD Se a ae le ee ey er ED 
COMMENTS tices pte ei tae 


BOARD NAME ee ee eee ee Ne ee D 
HOURS Sie ita cicada oat 
TELEPHONE NUMBER none 

CHARGES Y/N at a Ri aa 


PASSWORD: sisucl ecu ee oS 


COMMENTS x 


aie 

















«-- PERSONAL DATA GOLD --> 


BULLETIN BOARDS—LOCAL. 





BOARD NAME een et dane ace tie 
HOURS, oR ee ee aie 
TELEPHONE NUMBER ocecccecceeecee ener : 
CHARGES Y/N el net eat tae Bestes 
PASSWORD een 


013) | | Ut en oe Se Ens OR eit L fe 


BOARD NAME ee et SR SE IN Pe EEN TOE AEE 
HOURS 000 iat cee aerate armen 
TELEPHONE NUMBER oii. eee -, 
CHARGES Y/N Fee eA oT ET SATS ROE TERE 
PASSWORD. ccc tic ce ec ctl aati 
COMMENTS. 2th toetar a eae eee ee 


en NEI SI SP IE SP SIE SET I OT SE BEE SEE EEE) 


BOARD NAM scissile ta atc a mnllt cee 
HOURS Sa Nae Na aa ta calender 
TELEPHONE NUMBER Pee ee Pee Os eee AORN Te Eee Re = 
CHARGES Y/N Fe RE A DY SRC an ae ee em EE 
PASSWORD: ccc ica a ae tcl canta 
COMES a pea lect 


«-- PERSONAL DATA GOLD --> 


BULLETI N BOARDS NON-—-LOCAL 





BOARD NAME Sac ecg i a ant ca Salat 
HOURS eS a Anal lat si a SE cae = 
TIELEPHONE. NUMBER coccinea tet ammnnoete = 
CHARGES VIN etcetera eaten erie eres 
PASSWORD stacisecteretc oa ta ce regret i 
COMMENTS: (4-53.02 se 


a a al 


BOARD NAME Fe EP Oe haces ageniainc aah eee 
HOURS a ntl eh a ED eer iN le can 
TELEPHONE NUMBER ceccececccsscvennnunnnnsnnnnnniinnninnninnn S 
CHARGES Y/N seach ater ciate eae ie Raa toa 
PASSWORD, <oseee tee ks eh : 
a6) (| V1 | ne en een a ee — 


BOARD NAME areata Sr ee el ee ee 
HOURS dale nena ge ey Z 
TELEPHONE NUMBER ceceneeenercevereernnreenennenennntann 
CHARGES Y/N SS ee eee _ 
DAS SWORD je Mosc ee a et ce nee nee = 
COMIN NT ea PD a ccs : 


fs Vacs “Ele Ge. ee. Meee. +e SES 











«-- PERSONAL DATA GOLD --> 


BULLETIN BOARDS NON-—-LOCAL, 


ER EE I I A SS SE PE OD 


BOARD NAME See a oe an Seas! 
HOURS i aca ate alge ata acres aces 
TELEPHONE ‘NUMBER cpsiccetet te 
CHARGES Y/N nnn a a a a ea ane 
PRSSWORD «sSirnicieecccwnieteatepere tae a cel a a a 
COMMENTS 2 oneness teeta le te eee rom 


BOARD NAME ll DO ae a he ce stare neal m 
HOURS See ih et et Oa oe ee as a 
TELEPHONE NUMBER Si cate el Sacto 
CHARGES Y/N Eee ET NDS eR PEE er arene rete wen ay 
PR SSWORDY erected astrrererti Renmei aie tetiieatitanes Saccctni a 
10 8). | 1. Ms Sn Ro ct ce ot RE SORE Oe ever ae Settee OPES 


BOARD NAME Sc a te ate ca eee 
HOURS itt cima acl ea i aaa dee 
TELEPHONE NUMBER Te RAO eee Oe AE RNT a eS TER TERE Neen Be 
CHARGES: -N/N:.' «= ween et acne eneoieres eats 
PSS WORD ices hi tl cea ul cecal = 
COMMS ace a a le alam pees 


<«-- PERSONAL DATA GOLD --> 


BULLETIN BOARDS NON—-LOCAL 


SP SIS PP I EE TP EE ESE 


BOARD NAME ea la coca alte 
HOURS Pe eo DI CRETE Let eee mar cee PTE 
TELEPHONE NUMBER _ .......... 
CHARGES Y/N a te lee a ad 
PASSWORD: scsi te 
COMI TS ccc a relies 
ee 
BOARD NAME Se gee md eomenniceteate domes 
HOURS CLS WET Oe ae en eee Pere EON 
TELEPHONE NUMBER Ss ce es a A eats 
CHARGES Y/N a I a i cece 
PASSWORD: ore tiie cetera een 
COMMENTS: 222.455 eee Eres 
BOARD NAME Sk 
HOURS SP il Dec re ec la 
TELEPHONE NUMBER ati ta ahs 
CHARGES Y/N i a arial ei eat 


bg tee] 19454 2 Snes ia oats ER ee nn NO REP ee eee 


COMMIENT SS * ca ee 


ae | 











«-- PERSONAL DATA GOLD --> 


BULLETIN BOARDS NON-—-LOCAL 





BOARD NAME a Mac ae eae en clatioak anna bara eats 
HOURS 0, Rat a teat Mee 
TELEPHONE: NUMBER ciscsecncwsninininnnsnimimeitiniiis insane lt 
CHARGES: V/No 9 vwisibtniniiiiaiicgubouaiiiaeaces seh pasta Ss ses 
PRSSHORD) «xh Sl or SS ee al ar 


COMMENTO) | -2cctete ccc hence ieee teete tate OE 
LS ASE SPE PSE Tf SE SCT IPS ESI 


BOBRD NAMB cies ales teglettnn ce bees beeen oh a 
HOUR satan ee a Sealer ar pnremaleiiues aes 
TELEPHONE NUMBER eee ie CN een ae Se ee eee 
CHARGES: 27N 0 Gittencecnmmcnu recat a a rae 
PRD WORD cess sa selec aman lett os aaa eons a 


COMIN cece ala a ee a cece Soe a 


BOARD NAME PSEC ER STS NN AEC TE een ee Ee Oe 
HOURS Pa ee aCEN en NE ec renee PE IO ES OTON 
TELEPHONE NUMBER Si ca at eR cat 
CHARGES 9 /N (+ Seapets rentiantn chat tnlalaan tide cen acaacasnaidad 
PM ORD ac aca la a etd ener 


SCOPES 5 crac a realm hat, as 


=~ 259 - 


<«-- BALCK BOOK of C-128 --) 


REFERENCES 


Commodore Business Machines 
COMMODORE 64 PROGRAMMER'S REFERENCE GUIDE 


Commodore Bus. Machines & Howard W. Sams & Co.,Inc. 


Data Becker 
COMMODORE 128 INTERNALS 
Abacus Software, Grand Rapids, MI 
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The C-128 is one of the finest computers Commodore has 
ever offered. The Black Book of C-128 is a vast authoritative 
reference source, to assist programmers of all levels, from 
the beginning BASIC student, to the experienced machine 
language writer. Think of it as a dictionary, ready to answer 
your questions. The aim of the book, is to support the user, 
not teach BASIC programming. 


The BLACK BOOK of C-128 tells you everything you need to 
know about your Commodore 128, 1541, and 1571 disk 
drive. More than 100 easy to read charts plus numerous 
examples. All the topics vital to the operation of the C-128 at 
your finger tips. 
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